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THE OFFICIAL 
MAGAZINE 


e’ve been waiting to go all in on Android 
for a long time. We’ve all used Google’s 
mobile operating system, and the prospect 
of having a Raspberry Pi running Android is just too 
good to miss (page 16). The unofficial solution is a bit 
‘creative’, but we think it’s tons of fun. 
Speaking of creativity: the UK weather has always 
been a bit bonkers, but lately it’s gone full-blown 
bizarre. When it’s not blazing hot, it’s stormy, paoe me 
or chilly, and only a few months back we were in SUBSCRIBE — 
the depths of a bleak midwinter. We wouldn’t be ; 
surprised by frogs at this rate. 
So we are delighted to share Raspberry Pi’s new 
Weather Station instructions (page 70). Building 
your own weather station is an amazing summer 


project, and the output is a perfect introduction to 
measuring data. THIS MONTH: 


We’ve also got some extra-neat projects this 
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month, including the Seeing Wand (page 30) and 
Get Google's OS up and running 
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ADD AI 
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SEE PAGE 28 FOR DETAILS 


the Magic: The Gathering card analysis machine 
(page 34). Both use AI to push the Raspberry Pi 


further than we thought possible. If you are getting 44 BUILD AN OSCILLOSCOPE 
into AI, then don’t forget to install TensorFlow on a i i , 
, Measure signal voltage with a Raspberry Pi 
Raspberry Pi (page 58). 
There’s a lot to get stuck into this month, so let’s 58 INSTALL TENSORFLOW 
get started. Get started with Google's Al framework 
Lucy Hattersley 70 MAKE A WEATHER STATION 
Editor Come rain or shine, you'll know what's up 
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Break another record! 


Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While we 
attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. 
Raspberry Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi 
magazine. Laws and regulations covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible 
for understanding the requirements in your jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some 
projects or suggestions in The MagPi magazine may go beyond. It is your responsibility to understand the manufacturer's limits. 
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Build a Pi-powered weather station 
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CROWPI 


FLIES PAST ITS 
KICKSTARTER 


CAMPAIGN GOAL 


The case for hacking and making 


Below Plug in 

the power bank 
accessory and you 
can use CrowPi like 
a laptop or portable 
hacking station 


hinese outfit Elecrow’s 

latest project is a briefcase 

full of everything a 
hardware hacker and digital 
maker needs, from circuit boards 
and sensors to an integrated 
touchscreen display. 

CrowPi crams a big bundle of 
electronics into its hard-shell carry 
case, and is compatible with all 
versions of Pi 2, Pi 3, and Pi Zero. 
The case comes in four colours: 
black, purple, blue, and yellow. 


Among the fairly standard 
fare such as sensors for light, 
motion, and sound you will 
find various readout devices, 
an RFID sensor, an ultrasonic 
sensor, servo interfaces, a step 
motor connection, and a GPIO 
LED indicator. 

This panel helps debug 
circuits, as Elecrow sales and 
marketing manager Jarvan 
explains, “The status LED 
indicates when a sensor if working 
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and how, [which] gives you a 
better understanding of how 
microelectronics work.” 
Elecrow worked hard to “choose 
the most common and project- 
orientated sensors” to include, 
Jarvan reveals, but had to “make 
sure we can fit as many sensors as 
possible” into the Elecrow case. 
Jarvan adds, “We’ve tested a 
lot of LCD screens [to] choose 
the most suitable one, and even 
left some space [above] for the 
Raspberry Pi camera.” 


Crow funding 
Jarvan tells us that “the Elecrow 
philosophy is ‘make your making 
easier”, and this belief isn’t just 
represented in how CrowPi brings 
together so much hardware, but in 
its documentation too. 

“Ne” ve been working very 
hard writing those tutorials,” 
says Jarvan, modifying the 
documentation “hundreds of 
times in order to be as simple 
and understandable as possible.” 
This makes CrowPi as useful 
for schools and clubs as for 
individuals wanting a neat kit 
to develop code or hardware, 
according to Jarvan. 

CrowPi runs a standard 
installation of Raspbian, with only 
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the “basic drivers [required] in order 
for our hardware to operate right 
out of the box,” Jarvan confirms. 
“We wanted to modify the Raspbian 
image as little as possible, to keep 
the right for the customer to choose 
what they want.” 


Elecrow intends to sell 
CrowPi units through its website, 
elecrow.com, and Jarvan confirms a 
possibility “to sell it on our Amazon 
or AliExpress store.” 

For more details, visit the CrowPi 
Kickstarter page: magpi.cc/oUFbTt. 


Elecrow is based in Shenzhen City, 
China, the electronics capital of the 
world. Sales and marketing manager 
Jarvan was keen to point out the 
advantages of Elecrow’'s production 
line and gave us some glimpses 

of the process. 


CrowPi 


The Elecrow philosophy is comes in four 


colours and a 
few different 


make your making easier’ ii DË 


A basic, Pi-less unit costs $229 suits you best 
(6170), while the $369 (£275) 
Advanced Kit includes a Pi 3B+, a 
built-in camera, two gamepads, 
and a wireless keyboard and 
mouse, plus a few other hardware 
configurations to select. As 
Elecrow has its own production 
line, Jarvan says “delivery time 
and quality is guaranteed.” 


You can see the RFID contact pad to 
the Lower left of the CrowPi circuit 
board. RFID can be a fun and useful 


way to trigger events using an Android 
phone, or newer model iPhone. 


The buttons can be programmed to do 
whatever you like - the cluster might 
be used as a keypad while the four to 
the left could control a character in a 
self-made game. 
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'REVERSE-EMULATED 
SN 


e 


Pi plays SNES games on 


unmodified NES 


mulation is the process 
of running older software 
on newer, incompatible 
hardware, but Tom Murphy VII, 
a computer scientist from 
Pittsburgh, PA, wanted to turn 
that process on its head by 
‘reverse-emulating’ a SNES. 

The basic idea was to run SNES 
games ona NES, to tell a joke 
based on what Tom calls ‘improper 
hierarchy’. It’s not funny to run old 
software on new hardware, because 
software is meant to get better over 
time and older hardware is meant 
to become obsolete. However, 

Tom contends that it is funny 

to run newer software on older 
hardware, because that’s just an 
absurd thing to do, or an example 
of ‘improper hierarchy’. 

The crux of Tom’s reverse- 
emulation was to somehow fool 
an unmodified NES into running 
the SNES launch title Super 
Mario World, which he achieved 
by embedding a Raspberry Pi 3 
into a NES game cartridge. The 
Pi emulated the SNES game, but 
then had to convert the graphics 
into a form that the NES hardware 
could display. 

As Tom clarifies for us, the Pi is 
acting “kind of like a downsampler, 
although the SNES pixel resolution 
is actually the same as the NES, 
so it’s not downsampling in that 
spatial sense.” Instead, the Pi has 
to convert the larger numbers of 
colours in the SNES game into 
the limited colour palette of the 
NES. “I prefer to think of it like 
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The project 
required a 
bespoke circuit 
board, housing 


the Raspberry Pi, 

a reprogrammed | ËN iz 
NES PPU chip, Í i ARs vësh 
and a Nintendo Z 

CIC content 


protection chip 


I prefer to think of it like an 
absurdly advanced ‘memory 
mapper within the cartridge 


an absurdly advanced ‘memory 
mapper’ within the cartridge,” 
Tom tells us. 

While Tom admits that he might 
have had an easier build by using a 
bespoke microcontroller, he reveals 
that he used a Raspberry Pi so “ 
can have my whole development 
environment right on the device.” 
Rather than “swapping chips into a 
programmer, or even attaching an 
ICSP cable,” Tom continues, the Pi 
“really shortens the edit/compile/ 
test cycle.” 

Tom explains the many 
technical issues he had to solve 
in his fascinating video at 
youtu.befaroVVRvvCiSro. 


Tom 
originally used 
a Pi Zero W, but 
found it a little 
slow for the task 
so upgraded 
to a Pi 3 for the 
final build 
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CDP Studio is a development platform for industrial control systems, now coming with a free 
version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, I2C and MQTT. Its built in GUI design tool 
and features lets you code less and do more. 


Free download on 


CDP Technologies AS 
Nedre Strandgate 29 

P.O. Box 144 

NO-6001 Alesund, Norway 


Tel: +47 990 80 900 
info@cdptech.com 
www.cdpstudio.com 


CDPStudio 


MOONHACK 


2018 


his year’s Moonhack will 

be even bigger than before, 

with an estimated 50 000 
kids completing challenges and 
running projects to explore space 
on 20 July. 

As Nicola Curnow, national 
programme manager at Code Club 
Australia reveals, “We’re setting 
a world record, inviting every kid 
in the world to give coding a go, 
or impress us with their skills. 
[...] Last year we had 28575 kids 
from more than 50 countries 
participating; we’re aiming for 
50000 kids this year.” 


Help break a coding 
world record 


You can register for Moonhack 
at moonhack.com to get your 
school, library, Code Club, 
CoderDojo, or your family 
involved, but the nature of the 
projects is still “top secret stuff!” 
says Nicola. However, she tells us 
“The whole Moonhack campaign 
is designed to be super-accessible, 
so there is no hardware required 
to participate.” 

Moonhack projects are all 
space-themed, as the event 
celebrates the Apollo 11 
moon landing. Stay informed 
via #moonhack. 


Left Join the 
anticipated 50 000 
Moonhackers 
worldwide at 
moonhack.com 


MODULAR MAKING 


A LEGO kit for electronics 


Tibit 28 


Above Connect the modular Tibbits to the mainboard to prototype 
your hardyvare as easily as building a simple LEGO model 
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| a) 
Raspberry Pi. 


Raspberry Pi 3. 


Rather than using bread 
or soldering, the TPS uses 
Tibbit blocks to “implement 
an I/O function” by pluggi 
them into a TPS ‘mainboard’ 
(motherboard). Announced at 
this year’s Computex tech 
show in Taiwan, there will soon be 
a mainboard that incorporates a 


ibbo Technology’s Tibbo 
Project System (TPS) 

has been around for four 
years, but it’s finally comi 


ng to the 


boards 


ng 


nology 


It is unclear whether the Pi 3B+ 
will be supported, but with 60 
Tibbit blocks to add anything from 


power relays to audio converters 

to real-world sensors, you should 

be able to construct almost any 

project as quickly as a basic 

LEGO model. 

Details are still in the process 

of translation, but Tibbo confirms 

that Node-RED (JavaScript) is 

the standard coding language for 

Tibbo-Pi, and that C and Python 

are alternatives. 
An English brochure for Tibbo-Pi 

is planned, available through 

co-works.jp/tibbo-pi, but this site 

is in Japanese. However, Tibbo’s 

main site lists all the currently 

available Tibbits in English — 

see tibbo.com. 
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NOUGAT 
ON A PI 


Major update to RaspAnd brings 
Bluetooth and better wireless 


new release of the RaspAnd 
operating system brings 
Android Nougat to the 
Raspberry Pi 3B, preloaded with 
apps such as TeamViewer, Kodi, 
and Aptoide TV. 
RaspAnd is developed by Swedish 
outfit Exton Linux (exton.se), with 
modifications made to allow better 


automatically reconnects after 
every reboot. 

RaspAnd includes Google Play 
Services and the Play Store, 
meaning you have full access to 


any app hosted on the main Store. 


This includes the recommended 
version 4.6 of Spotify and version 
18.0-Alphaz2 of Kodi. 


RaspAnd Nougat 7.1.2 
incorporates Bluetooth 


support and compatibility with 
standard Raspberry Pi hardware. 
Alas, only the Pi 3B is supported at 
this time — the Pi 3B+ is not. 
Crucially, RaspAnd Nougat 7.1.2 
incorporates Bluetooth support 
for the first time, as well asa 
‘stable’ wireless connection which 


To install RaspAnd, you need 
to download the image from 
magpi.cc/SALgip, which costs 
So, and burn it to a microSD card 
using whichever method you 
prefer. Then follow the advice 
on RaspAnd’s information page: 
magpi.cc/ATERWE. 


RaspAnd is an easy way to deploy Google's Android OS on your Raspberry Pi 3B 
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The stories we shared 
that flew around the world 


magpi.cc/dUGpoR 


Peter Juett's project uses standard components to show 
information such as weather and air quality, and allows 
you to control smart lights and other loT devices such as 
WeMo smart plugs. 


magpi.cc/gPUAnS 


Google's NSynth system uses Al learning algorithms 
to create new sounds based on samples of musical 

instruments. The NSynth Super houses this next-gen 
synth in a touchscreen device you can build yourself. 


—— CAMBRIDGE, UK —— 
30 JUNE - 1 JULY 2018 


magpi.cc/xwwGPL 


Come to the first annual festival of technology 
and science, held at Cambridge Junction over the 
weekend of 30 June and 1 July. Highlights include 
brewing a magic potion and Museum in a Box. 
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HIGH-ALTITUDE RASPBERRY PI GLIDER 


HIGH-ALTITUDE 
RASPBERRY PI 


GLID 


Effortless HAB data recovery 


zzy Brand, a student at 
Brown University, USA, 
created a clever system 

to recover the data from his 
high-altitude balloon (HAB). 
Rather than use a parachute and 
geolocator, he instead fitted the 
data module to a glider set to land 
at preprogrammed co-ordinates. 

Izzy reveals, “I had the idea 
a long time ago — maybe early 
high school (2013).” Initially the 
idea was just to find a way to flya 
glider, dropping it from a hot-air 
balloon, as Izzy’s “nearby hills 
weren’t steep enough.” 

The glider uses a Raspberry 
Zero W and a Pixhawk, a flight 
controller powered by an ARM 
processor. “I chose the Zero W,” 
Izzy explains, “because it can run 
MAVProxy, essentially a terminal 
version of the GUI-based ground 
station software used to control 
the Pixhawk.” Izzy chose the 
Pixhawk due to his familiarity with 
its predecessor, the ArduPilot. 

At 10000m, the Zero W turned 
on the autopilot mode and 
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“triggered a solid-state relay to 
burn the nickel-chromium wire 
and release the glider.” 


Guided landing 

Izzy explains that the Pixhawk 
module’s autopilot mode operates 
on a system of waypoints, so he set 
“only one waypoint co-ordinate at 
the target landing location, with 
an elevation of zero.” 


Left Izzy's glider isn't 
anything fancy - 
mainly foam board and 
corrugated plastic, 
with handwarmers to 
keep the electronics 
inside from freezing 


Above The day of 
the launch, using a 
$60 military surplus 
sounding balloon to 
send the glider into 
the atmosphere 


was waiting just 10m from the 
target location. 

“We were astonished,” Izzy 
tells us. “This project failed 


I had the idea a long time ago — 
maybe early high school (2013) 


In addition, the Pixhawk doesn’t 
have a glider mode, so Izzy had to 
“set the maximum ascent angle 
to zero so the glider wouldn’t 
try to climb without a motor and 
thereby stall.” 

Amazingly, after launching the 
balloon and driving to the landing 
site 122 miles away, the glider 


miserably in 2015, [as] the glider 
landed in a forest about ten miles 
from its target.” 

Izzy would like to thank his 
friends Luke Fisher and Nick Menz 
for their help “in testing the glider 
and on the launch day.” You can 
find the source code and flight logs 
at magpi.cc/qkqKXj. 
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NEW COMPUTER SCIENCE COURSE FOR IRISH SECONDARY SCHOOLS 


NEW COMPUTER SCIENCE COURSE FOR 


; Below The CSTAI collaborates with other organisations, 
including CoderDojo; CSTAI President Stephen Murphy 
meets CoderDojo's Tara McGrath and the team from 


the Cork Institute of Technology CoderDojo 


Computer Science Teachers’ 
Association of Ireland helps 
schools prepare 


he third element of the Irish government’ s 
computer science curriculum will be trialled in 
September, and the Computer Science Teachers’ 
Association of Ireland (CSTAI) is ready with resources 
to help teach the new Leaving Certificate, Computer 
Science course. 

Following the previous Junior Certificate short 
courses in Coding and Digital Media Literacy, the new 
course aims to “develop an appreciation of the diverse 
roles of computing technology in society and the 
environment in which [students] live,” according to 
CSTAI President Stephen Murphy. 

The course specification outlines that “embedded ca 
systems (such as the Raspberry Pi) vvill play a central 
role in the practical component of this subject,” 
explains Stephen. N D U S TRI 

He tells us that “over 200 schools applied for the 
Leaving Certificate, Computer Science pilot scheme,” 


of which 40 were selected. The Leaving Certificate, G O Pi G O 
Computer Science “will open as an elective subject for 


all schools to offer if they so wish” in September 2020. 20+ new p roj ects for your Pi robot car. 


verë” Computer Science Teacher’ SO” 


W Association of Ireland W 


—— ——— 


Riomheol Oidi na hEireann 


Above The CSTAI supports teachers of computer science, coding, 
and digital media literacy 


D » 

Supporting teachers e e 
While the Irish government has been described B ri C KP l 3 
as providing “excellent” support for teachers 
wishing to teach any of the three courses, the CSTAI LEGO MINDSTORMS + RASPBERRY PI 
supplements that with “hundreds of teaching 
resources (PowerPoints, worksheets, videos, etc.) for 
coding, computer science, digital media, and general 
computing courses,” Stephen reveals. 

Access to these resources is free for CSTAI 
members; to become a member, visit magpi.cc/dTiylU 
or email president.cstai@gmail.com. 


The CSTAI was founded in November 2017 and has I 7 
“over 440 members from Ireland, UK, New Zealand, www.dexterindustries.com 
and Dubai,” says Stephen. 
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@ www.pi-top.com 


pi-top 


Inspiring inventors and creators to 
seek the skills of tomorrow and 
create their future, today. 


The modular laptop with sliding keyboard 


Q ® O E 


8HR BATTERY 14” FULL HD 180 CUSTOM MODULAR 
LIFE 1080P SCREEN HINGE PASSIVE COOLING RAIL 
BRIDGE 


The modular desktop 


a K 


14” FULL HD MODULAR ADJUSTABLE 
1080P SCREEN RAIL VIEVVING ANGLES 


pi-topPROTO pi-topSPEAKER 


© @GetPiTop 


@ /GetPiTop 


POWERED BY 
GS RASPBERRY PI 
eee EE 


OCR 


Oxford Cambridge and RSA 


pi-top 
Colors A 
Raspberry Pi 3 optional 


AWESOME INVENTOR’S KIT INCLUDED 
20+ projects 
to explore 


Explore beyond the screen and keyboard by 
creating with the all-new pi-top modular laptop. 


Get started with 20+ inventions in the inventor's 
guide booklet. There are 3 inventor's journeys - 
Smart Robot, Music Maker and Space Race. 


pi-topCEED 


Colors M 
Raspberry Pi 3 optional 


pi-topCEED is the plug & play modular 
desktop. It's the easiest way to use your 
Raspberry Pi. We’ve put what you love 
about our flagship laptop in a slimmer 
form factor. Join hundreds of code clubs 
and classrooms using pi-topCEED as 
their solution to Computer Science and 
STEAM-based learning. 


Modular 
Accessories 


Stay up to date with our latest news by following our social media 


pi-top is an avvard-vvinning ecosystem designed to make 
experimenting, coding and building electronics, simple, 
affordable and fun. pi-topOS is here to guide you through 
the world of making! 


The OCR” endorsed pi-topOS (Operating system) platform 
comes pre-installed on the SD card shipped vvith every 
unit. pi-topOS software suite lets you - browse the web, - 
check emails, - create and edit Microsoft Office 
compatible files. Gain access to dozens of hands-on 
learning lesson plans with pi-topCODER and have fun 
learning to code with CEEDuniverse! 


CEEDuniverse 


ta 


pi-topCODER has a fully 
integrated coding environment 
letting you program hardware, 
code in Python and learn Lots 
of STEAM skills! Our integrated 
test framework gives you the 
ability to assess your own 
understanding as you Learn. 


CEEDuniverse 


Learn programming concepts 
through our minigames, 

for example, learn problem 
decomposition by solving 
visual programming puzzles. 


=— => & & 
i TJ Ia dt 


“SH RUN rërë 


ANDROID 


ON RASPBERRY PI 


How to get Google's Android operating system working on your Pi! 


he Raspberry Pi has been 
used in many different 
ways over the years by 


many different people. Installing 
Android on Raspberry Pi, while a 
pretty popular idea, has never been 
super-easy, though. Solutions have 
existed in the past, but have never 
worked like true Android. 

Recently that’s all changed. 
While limitations stopping Android 
working properly on Raspberry 
Pi were lifted some time ago, it’s 
taken until now for a build of full 
Android to be created by budding 
hackers to run on the Pi. We look 
at emteria.OS, the first proper 
Android release for Raspberry Pi. 

That’s not the only way to use 
Android on Raspberry Pi either, as 
Google has released an loT-focused 
version called Android Things. 

Not sure which one to use? We’ll 
show you how to use both, and 
why you might want to, over the 
following pages... 
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CHOOSE 
YOUR 


Things or emteria.0S? 
You decide! 


© 


Emteria.OS is a full build of Android available for Raspberry 
Pi. While you can get it for free and use it as an individual, 
it's aimed more towards industry. Embedded Android 
devices are big business, and marrying the mobile OS 
with the Pi opens up a whole new world of Android in both 
maker projects and consumer products. 

PAGE 18 


android 
things 


© 


This stripped-down, official release of Android is perfect 
for loT applications. It's a lot more simplistic than full 
Android, and you need to program it from a separate 
computer. However, we've seen people do some amazing 
things with it - see some of them on page 26. 

PAGE 22 
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p INSTALL 


EMTERIA.OS 


Installing Android onto your Raspberry Pi made easy 


t’s been a long time 

coming, but finally there’s 

a proper way to install 
full Android on your Raspberry Pi 
thanks to emteria.OS. Based on 
RTAndroid, this stable version is a 
bit more aimed towards business; 
however, more personal-use 
versions will be coming soon. 
Here’s how to set it up. 


01. Desktop 

The main desktop will be familiar 
to those that have used Android 
as a tablet device. 


02. Mouse control 

While emteria.OS does work 
with a number of Raspberry Pi 
touchscreens, you can still use it 
with a mouse and keyboard. 


03. F-Droid 

F-Droid is an app store alternative 
available on emteria.OS, allowing 
you to install a number of free apps. 


04. App drawer 

All your other apps live in here 
and, like on other Android devices, 
you can move them onto your 
main display. 


Contacts 


«> 43:14 
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STEP 01 


You'll need to first register an account on 

- look for the Register option on the top right of the 
home page. Fill out the relevant details, confirm your 
email address, and then make sure you’re logged into 
your account on the emteria.OS website. 


Finish Registration 


Enter Your Details for Instant Access 


Account Settings 


Personal Information 


STEP 03 


All you need to do now is open the installer, enter 
your emteria.OS username and password, and 
select the Raspberry Pi 3 as your device of choice 
for installing. Next, you’ll need to select your 
microSD card as the installation location and 
then just wait - the installer will download the 
image and then burn it to your microSD card. 
Now you’re ready! 


EMTERIA 


your@email.comt 


AUTHORIZE 


STEP 02 


From your emteria.com account you can download 
the installer for your system. This will burn the 
image for emteria.OS onto a microSD card to be 
used in a Raspberry Pi. On Windows you’ll have to 
install the installer using the setup wizard, while on 
macOS you’ll have to drag it into the Applications 
folder and run it using superuser in the Terminal. 


Emteria.OS prices 


Cr) 
Ô Device Activation 


During the 
initial setup 

of emteria.OS, 
you'll be asked 
to activate your 
device witha 


licence - clicking Next allows you to continue on 
with emteria.OS and use it for free. There are some 
limitations, however: it only stays on for eight hours 
at a time, and has a watermark in the corner. Perfect 
for testing it out with a few projects, though! 


There are full licences for purchase on emteria.com, 
including a cheaper ‘personal’ option and one suited 
for business that includes bulk-buy discounts. 


Pricing 


Available Licensing Plans 


Evaluation 0 = 
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INSIALLING 


APPS 


Here are some extra vvavs to install 
software onto your emteria.0S-povvered Pi 


NevvPipe 
Play YouTube videos on 
your device vvith this small, 
lightweight app that doesn't 
require the original YouTube 
app to work. 


Terminal Emulator 
As emteria.OS is a bit more 
hackable than stock Android, 
you'll be able to make good use 
of this terminal emulator to run 
more advanced commands. 


Face Slim 
Missing out on some social 
media time? Face Slim allows 
you to use Facebook much like 
the standard app. 


INSTALLING F-DROID APPS 
Start F-Droid 


Find F-Droid on your home screen on in the apps 
menu and start it up. It won’t launch straight away 
as it will first need to update all its repositories - 
something you’ ll be familiar with from installing 
software on Raspbian using apt-get. This might 
also take a while so please be patient. 


3:15 PM “ Thu, Jan 11 ej v 


a o 


Updating repositories 


Find an app 


F-Droid works very similarly to the usual Play Store 
on normal Android devices. There are categories 
you can look for apps in, and you can also search 
for something you like. Some of your favourite apps 
on Android may even be available. 


Install! 


Select the app you want, then hit the install button. 
It’s as easy as that - F-Droid even includes some 
info on the apps as well. F-Droid also lets you 

keep the apps up-to-date, although it’s a bit more 
manual than the Play Store equivalent. 


Yalp Store 


by Sergey Yeriomin 
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Teature 


SIDELOADING 


STEP 01 STEP 03 


Android apps work by 
downloading a specific file 

which is then used to install the 
software onto the device. These 
files are called APKs, as that’s the 
file name extension (.apk). If you 
have the APK file, you can install 
it on Android without having to 
go through a separate store. 


Once the APK file has been downloaded, 
open it from the Downloads menu. You may 
need to enable installing from unknown 
sources if you’ve turned that option off in 
the emteria.OS settings - otherwise it will 
go about installing the Netflix APK for you. 
It will appear in your app menu as usual, 
although yov’ll need to perform manual 
updates every now and then! 


STEP 02 


NETFLIX 


F-Droid specialises in free and open-source 
Android apps, so you may not find everything you Popular on Netflix 
want on there, such as Netflix. As Netflix is more ws 
concerned about you being able to watch the shows ia AA. BUS LER 
you’re already paying for, the APK for the app is Pat et fiz: 
available from its website. Open the browser in } $ A 
emteria.OS and head to 


Trending Now 


AA 


love isl 


Using the Google Play Store 


With custom versions of Android, there are some restrictions. One of 
the big ones is that the Google Play Store and some of the proprietary 
Google apps are not allowed to be included with software. However, 
this doesn't stop you from installing APKs using sideloading. 
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Teature 


INSTALL 


simpler way of putting Android on the 
Raspberry Pi, Android Things is optimised 


You too can do loT with more for IoT. You won’t be getting your home 
Android Things and a Raspberry Pi screen or app menu or anything like that, but you 


can program it to be a bit more customisable than 
stock Android. 


5 androidthings “edh STEP 02 


On Windows, you”ll need to right-click on the 
Setup Utility EXE (which has ‘windows’ in the file 
name) and run it as Administrator. On macOS and 
Linux, you’ll need to run it from a terminal with 
something like: 


sudo ~/Downloads/android-things-setup-utility/ 
android-things-setup-utility-linux 


...but making sure to point towards the correct file 
in the correct folder. 


STEP 01 
android-things-setup-utility-linux 
Head to the Android Things console android-things-setup-utility 
( ) and sign in with your Google Ga ee —— 
account. Click on the menu in the top left to find @ Runas peministrator 
the Tools section, where the Android Things Setup Troubleshoot compatibility 
Utility lives. You’ll need to download this and then Run with graphics processor 


; i pë : E nee 
unzip the files within - there’s no extra installation aes ae 


for the setup utility. 


II Edit with Notepad++ 
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RUN ANDROID ON RASPBERRY PI 


Flash the SD card 


A command prompt window will appear with two 
options - you”ll want to choose ‘Install Android 
Things and optionally set up WiFi’ by typing 1 
and then ENTER. Next, choose Raspberry Pi 3, 
and then get the default image when prompted. 
Make sure you have a microSD card ready to 
flash for when it asks for it to be inserted after 
the download. Follow along with the rest of 

the prompts to select the card and wait for i 
it tobertlashed, plug the so card into your computer. Press [Enter] when ready 


5 to the Android 


Android Things Setup Utility (version 1.0.21) 


This tool will help you install Android Things on your board and set up Wi-Fi. 


What do you want to do? 

1 - Install Android Things and optionally set up Wi-Fi 
2 - Set up Wi-Fi on an existing Android Things device 
|2 
What hardware are you using? 
il - Raspberry Pi 3 

2 - NXP Pico i.MX7D 

iL 
You chose Raspberry Pi 3. 


Setting up required tools... 
Fetching additional configuration... 
Downloading platform tools... 

4.74 MB/4.74 MB 

Unzipping platform tools... 

Finished setting up required tools. 


Please plug your Raspberry Pi to your router with an Ethernet cable, then press [Enter]. 


Setting up wireless internet 


Once flashing is done, you can take the microSD 
card out and put it into your Raspberry Pi. At the 
very least, you need to have the microSD card 
inserted and have access to a power supply. If you 
still have the setup utility open, you can then set 
up the wireless internet on your device by also 
plugging an Ethernet cable into the Pi. If you’ve 
exited the setup utility, just start it up again and 
choose the second option. 


Unfortunately, Android Things does not support 
the Pi Zero - it requires a bit more power than the 

board can currently provide, so you'll need at least 
a Raspberry Pi 2 to run Android Things on, 
but preferably a Pi 3. 


Alternate wireless setup 


If you don’t have access to wired internet, you 

can always plug the Pi into a monitor and use the 
included utilities to connect to your WiFi for further 
configuration. You can also do it via adb (Android 
Debug Bridge) if you want to get into the nitty- 
gritty of wireless setup — find out more info on that 
here: magpi.cc/PHWvQR. 
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5V 
5V 
Ground 
BCM14 
Ground BCM15 
BCM17 BCM18 
BCM27 Ground 
BCM22 BCM23 
3.3V BCM24 
Learning how to use ground 
the loT-focused Android BoMes 
BCM8 
rogramming Android Things is much like BCM7 
making an Android app. It can make use of 
Google services and is programmed in Java. 
This means it’s a bit more advanced than using Ground 
Python in Raspbian - even something as simple as 
lighting an LED takes a lot more time than using the BANE 
Python GPIO Zero library to do so. Ground 
Software is built into Android Studio and then 
uploaded to your Raspberry Pi — this way you can BCM16 
quickly prototype and test your code before updating it BEM20 


and testing again. It also means you can have multiple 
projects on the go that use the same Pi — you just need 
to switch between them. 


BCM21 


12C1 (SDA) 


Grab the Android VAG (SCR 
Studio software from SPIO (SS1) 
magpi.cc 7 DqPMKe. SPIO (SSO) 
Install it and then SPIO (MISO) 
open it, and go to SPIO (MOSI) 
‘Start a new Android SPIO (SCLK) 
Studio Project’. Call PWM1 


UARTO (TXD) or MINIUART (TXD) 
UARTO (RXD) or MINIUART (RXD) 
1251 (BCLK) or PWMO 

l251 (LRCLK) 
1251 (SDIN) 
1251 (SDOUT) 


it whatever you wish 

and then select 

Android Things as the 

form factor, with the 

latest SDK. You can then access your project through here, including 
any previous code you've created or edited. 
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RUN ANDROID ON RASPBERRY PI 


GREAT 
STARTER 
PROJECIS 


b 
i A atë 
j I] fy 
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\ y p Sa 
| IN I bë “ ~ 

Mi IT IT n. 
CI A Ei 


i ii P Li 


LED blinker K3 magpi.cc/cKFQQWw LED vvith a button K3 magpi.cc/FKSVLp 
This beginner’s tutorial shows you how to blink an A follow-up tutorial to the LED blinker, this adds 

LED using Android Things. While it’s much more input command code to the already present output 
complex than using GPIO Zero, you’ll be using Android code for the LED. From here you can begin to see how 
Things for more than just controlling electronics via the code reacts to events, and you can start building 


the GPIO. It’s well explained and gives you a nice basic slightly more complex circuits as well. 
tour of the Android Studio work area. 


Using Bluetooth @ magpi.cc/QbDjXY 


Jumping ahead, this tutorial teaches you how to make 
use of Bluetooth communication on your Raspberry 
Pi with Android Things, which is slightly more robust 
than the available Python libraries you might use in 
Raspbian. From here you can start truly developing an 
interesting project for yourself. 


THINGS RESOURCES 


Android Things Hackster.io Raspberry Pi 
documentation Android Things projects Forums 

The basic information for Many people use Hackster.io to post Need some help with your 
Android Things is a good place and document their builds, and there Pi project? The Raspberry Pi 
to look for all your Android Things are plenty of projects to find on here forums are the best place to 
needs - it also covers other for both beginners and advanced go to ask questions about 
devices, which may be of use to users alike. There's even a special what you're doing - you may 
you if you're planning to branch Android Things tag for those kinds of even be lucky enough to find 
out with what your Things app projects, and you can further filter it by an existing thread that solves 
will work on. Raspberry Pi projects. your specific issue! 

9 magpi.cc/BraebS 9 magpi.cc/gpmLrZ 9 raspberrypi.org/forums 


$ Bluetooth’ 
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Not sure where to get started with Android Things? 
Here are some cool projects to help inspire you! 


Sentinel K3 ~Magpi.cc/YsxVco 


Looking for a home security robot? Well, you might 
want to keep looking (and wait a few decades), but you 
can build this semi-autonomous Pi robot that’s able to 
provide some level of security. 

The Sentinel follows the maker’s dog, as he 
wanted to see how it’s getting on while he’s not 
home. Sentinel was cheaper than IP cameras. Facial 
recognition has also been added, as well as text-to- 
speech so the robot can talk to you. 


BrailleBox  magpi.cc/dxMNje 


An ingenious project to help blind people stay informed, 
the BrailleBox at its simplest loads news stories from 
the internet and then translates them into Braille for the 
user to be able to read it. 

The project has evolved beyond this initial concept, 
though, allowing the user to slow down or speed up 
news reading, and to press a button for the device to load 
the latest news story from News API (newsapi.org). 
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© iicc/wZb¢ © 


This recent project took the internet by storm, using While analogue watches may be a great fashion 
an off-the-shelf IKEA lamp and turning it into a statement, they’re not quite as convenient as digital 
laser-projected smart interface. It’s all high-tech and watches. Or this word clock, which writes out the time 
futuristic and runs simply on a Raspberry Pi 3 with using letters cut out of a board. 
Android Things. You can control the colours of the LEDs through 

As well as smart interfaces, it can project what a dedicated companion app, or by connecting it to 
the makers call “ambient data’ onto a surface: say, a Google Home assistant. Ideal for lowering the 
a scrolling weather forecast onto a wall, or a ‘now brightness while you watch a film or to set the 
playing’ info screen on the edge of a thick side-table. nerdiest mood lighting imaginable. 


Another project designed for people with vision 
impairments, these glasses look ahead of the wearer and 
tell them what’s in front of them using Google services 
such as TensorFlow. 

This could be modified to be used a bit like a futuristic, 
high-tech smart display, showing you what’s ahead, or 
even to help create advanced automation in a robot. 
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Pi Zero W 


Pi Zero W case 
with three covers 


USB and HDMI 
converter cables 
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Projects SHOWCASE 


Hidden inside the PVC tube, 
a Speaker pHAT is used to 
speak the item description 


One push-button is used to take a 
photo of an object; the other turns 
the Pi Zero W on and off 


ROBERT ZAKON 


Robert Zakon is a technology 
entrepreneur and former White House 
Presidential Innovation Fellow who lives 
in the mountains of New Hampshire 
(USA) with his wife and their two 
wondrous sons. 

zakon.org 


A Pi Camera Module 
at the end of the wand 
takes a photo of the 
item to be identified 


Point this magic wand at an item and it’ll speak its name. 


Phil King lifts the curtain to see how it’s done 


nspired by a blind cousin cognitive computing services,” 
Build details who would ‘look’ around explains Robert. “They were a bit 
are at his environment by way sceptical at first, but warmed up to 


i.cc/ ‘ i 
pop of touch, Robert Zakon has built it and thought the end result was 


r a Seeing Wand that can speak the pretty awesome (their words). My 
The wand is ae A 7 
programmed name of whatever it’s pointed at. eldest helped with assembly, and 
using Python Housed in a makeshift PVC tube, both aided in testing.” 


Godeison a Pi Zero is connected to a Camera 
GitHub: Module that takes a photo vvhena First taste of Pi 
E push-button is pressed. The image Roberts debut Raspberry Pi 
is sent to Microsoft’s Cognitive project, it came together over the 
Services Computer Vision API to course of a few weekends. 
get a description, which is then Asked why he chose Microsoft 
ree spoken - using the open-source Cognitive Services over other 
identifications eSpeak speech synthesizer — image-recognition APIs, Robert 
lus through a Speaker pHAT. responds: “Microsoft did a nice 
“I was looking for a way to teach job with the API and it was fairly 
my kids about innovation through straightforward to integrate with. 
integration and had been wanting There was no particular reason for 
to test out both the Piandemerging choosing it other than it appeared 


A Microsoft 
cloud API is 
used for ID 
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Point the wand at an item, press the 
button, and its description is spoken 
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>STEP-01 

Wiring the electronics 
Components include a Pi Zero W, 
Camera Module, and Speaker 
PHAT. Wiring is currently via a mini 
breadboard. The device is powered 
by a 2200 mAh power cube. 


to be robust enough and free to use 
for our project.” 

The results surprised him in 
terms of accuracy and level of 
detail: “People, pets, and large 
objects seem to be the sweet spot.” 


>STEP-02 
PVC housing 


The electronics are crammed into a PVC 
tube. The camera fits into a closet-rod- 
supporting end cap and is held in place by 
rigid insulation, with its lens up against the 


cap's screw hole. 


As per its original inspiration, 
however, the Seeing Wand could 
be of serious use to partially 
sighted people. “Although there 
are smartphone apps that do the 
same thing, this could be a less 


Even when the wand gets it 
wrong, the results can be amusing ff 


Even when the wand gets it 
wrong, the results can be amusing. 
“My kids had a lot of fun whenever 
something was misidentified, such 
as pointing at a toy robot on a table 
and having it identified as ‘a small 
child on a chair’. Another example 
was pointing at our garage witha 
sloping roof and being informed 
there was ‘a skateboarder coming 
down a hill’ — still not sure what it 
thought the skateboarder was. My 
favourite, though, had to be when 
we pointed it at clouds and heard 
what sounded like ‘Superman 


ee 


flying across a blue sky’. 
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expensive and more human- 
friendly device.” 


Fine-tuning 

Robert admits that the prototype 
wand is a little rough around the 
edges. “We have talked about 
making improvements both to the 
hardware and software. On the 
hardware side, we would solder 
all wires and buttons, and use a 
smaller battery in order to make 
it truly palm-sized and thinner 
so it could fit as the holding end 
of a white (blind) cane. For the 
software, we’d like to integrate 


>STEP-03 
Two buttons 

The breadboard holds two push-buttons: 
one to take a photo of the item you want 
to identify, and the other - wired to the 
GPIO 03 and GND pins - to turn the Pi 
Zero W on and off. 


the text recognition and possibly 
language translation services so 
signs and printed material could 
be read, and the face recognition 
service so people could be 
identified. Also, as the cognitive 
services are not yet perfect, it 
would be interesting to ‘poll’ 
multiple services and determine 
which identification is best through 
our own cognitive meta-service.” 


A Pi Camera Module is used to take photos of items, 
while speech is output through a Speaker pHAT 
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A mechanical arm below the board 
moves the pieces. By shifting them to 
the corner of a square and then only 
moving along the square edges, it 
avoids collisions with other pieces 


Each chess piece has a button 
magnet on the bottom. The 
magnetic field needed to be strong 
enough to hold the piece while not 
attracting surrounding ones 


A Raspberry Pi 3 runs the Stockfish 
chess engine. This allows the 
computer to decide on its moves, 
with software also controlling the 
robotic arm under the board 


GHOST CAPSS 


With this game of chess by Tim Ness, Alex Angelov, and Alex Smith, 
the pieces appear to move by themselves. David Crookes checks it out 


> Each chess 
piece is 3D 
printed 


> Forty 3mm 
button 
magnets 
are used 


> The arm's 
electromagnet 
has a 4.5G 
pull force 


> It's controlled 
using GPIO on 
the Pi 


> Chess engine 
Stockfish is 
open-source 
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n 10 February 1996, a 

chess-playing computer 

called Deep Blue sent 
shock waves around the globe by 
beating world champion Garry 
Kasparov in the first of their six 
games. But the IBM machine did 
so without moving any physical 
pieces itself - a human noted the 
computer’s move and performed it 
manually on the board. Had Ghost 
Chess been around back then, 
however, such intervention would 
have been redundant. 

Designed by final-year MEng 

students Tim Ness, Alex Angelov, 
and Alex Smith from the University 


of Glasgow, Ghost Chess makes 
use of a robotic arm connected 

to a Raspberry Pi running the 
world champion chess program, 
Stockfish (stockfishchess.org). 

It focuses attention on a physical 
board, using motors and an 
electromagnet to pick up, move, 
and place 3D-printed chess pieces 
within the squares depending on 
the moves dictated by both human 
and computer. 
As such, it’s a mini-marvel - 

a prime example of a real-time 
embedded system. “We wanted 
to create something that was fun, 
memorable, and slightly more 


challenging — an ‘automatic’ 3D 
chess game from scratch,” says 
Tim. What’s more, they wanted 
to make it as unobtrusive as 
possible. “We kept the robotics 
underneath the board because it 
was an easier way of designing the 
system,” Tim adds. “It keeps all 
of the electronics and the moving 
mechanism out of the way.” 


Multilayered project 
Indeed, the project is broken down 
into five layers: the chess pieces, 
the board, a matrix of sensors, 

the mechanical arm, and, at the 
bottom, the Raspberry Pi 3. Of 
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those, the arm was the trickiest 
part to develop. “Creating a design 
without having access to expensive 
ball races/bearings was a real 
challenge,” Tim recalls. 

T-slot bars bolted to a plywood 
base act as runners for two shuttles 
and these are hooked up to timing 
belts mounted through a couple 
of pulleys to a stepper motor, 
allowing the arm to move left, 
right, up, and down. Meanwhile, 

a matrix of 64 latching Hall effect 
sensors (one for each square and 


There was a lot of difficulty 
integrating all of the different 
parts of the system 


capable of varying the output 

voltage in response to a magnetic 
field) lets the setup detect which 
spaces on the board are occupied. 

From that point on, it’s up to the 
software running on the Pi to work 
its magic. For this, the students 
coded their own program to work 
with the Stockfish API. It not 
only allows humans to enter their 
moves through a graphical user 
interface or via a command line, 
it also empowers the computer to 
decide where it needs to go. 

“The RPi is a versatile platform 
for development which provides 
competitive input and output 
capabilities, compared to other 
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GHOSTCHESS Projects 


devices,” says Tim. “We used TIME TO 

Raspbian as the platform for 

development, which allowed us MAKE A MOVE 
to create a GUI fairly easily and 
helped a lot with the development 


and debugging process.” TË NI Select difficulty: 
ry ® Easy © Medium © Hard 
i j Enter Move: 
Moving pieces = — 
i i ele onfirm 
Oncea mowe is decided, the Se ee 
software instructs the arm to make b2b4 c6b4 F1c4 b4c2 


e1e2 c2d4 


its way to a piece. It then turns on 
the electromagnet positioned on 
top of the arm, which attracts a 
button magnet fitted to the bottom 


of each piece. At this stage, the 
robotic arm can start to perform 
the move. Seeing physical pieces 
move across the board is far more 
satisfying than simply playing 

on a computer. 

“There was a lot of difficulty 
integrating all of the different 
parts of the system and calibrating 
them in order to work as 
expected,” says Tim. “We think 
the trickiest part was trying to 
work on a tight budget and design 
solutions for different parts of 
the system, without breaking the 
bank, and we hope the idea will be 
passed on and upgraded during the 
coming years.” 


Sensors are 


positioned below 
each of the 64 
squares. They detect 
which squares are 
occupied and feed 
the information back 
to the software 
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> The build 
and code 
took Michael 
ten hours 


> It uses LEGO 
bricks - and 
plastic tyres 


> The various 
components, 
Pi included, 
cost $115 


> 20-25 cards 
can be 
recorded 
per minute 


» There are 
20000 official 
MTG cards 


SCANNER/ORGANISER 


For his next trick, Michael Portera created a system out of 
LEGO to recognise, organise, and value his vast collection of 
Magic: The Gathering trading cards. David Crookes investigates 


hen Michael Portera 

came across a few boxes 

packed with trading 
cards — “everything from football, 
baseball, and basketball to Magic: 
The Gathering (MTG)” — one of 
his first thoughts was how much 
the collection might be worth. As 
someone who had dabbled with 
MTG by buying booster packs and 
playing the occasional game with 
friends, he knew there was a large 


secondary market and that he had 
cards worth investigating. 

“But looking up the cards 
manually would have taken a 
while, even using online scanners 
or apps,” he muses. “So I wanted 
to develop an automated process 
using a card feeder and a scanner for 
image processing.” 

Motivated by the potential time 
saved, he quickly got to work. The 
spell-binding result was a scanner 


made of LEGO, servo motors, a 
camera, and a Raspberry Pi 3. 


Shuffling cards 

Right from the start, Michael 
envisaged a simple system that 
would spin and push preloaded 
cards forward to be photographed 
and uploaded for digital storage and 
processing. The idea was to make 
light work of organising and valuing 
even the largest of collections. 


The LEGO platform took a couple 
of hours to build. It stores the 
cards and readies them for 
individual scanning 


The project is designed to work 
with Magic: The Gathering trading 
cards. The fantasy game has 
echoes of Dungeons & Dragons 


This unit contains the Camera 
Module and Pi 3. The short length 
of the camera's ribbon cable 
caused problems 
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Michael used the free 

tier of Amazon's object 
storage service S3 
(aws.amazon.com/s3), 
which allows 2000 images 
to be uploaded each month 


Building it, however, was largely a 
process of trial and error. 

“I had a cheap card shuffler 
ying around,” recalls Michael. 
“After taking it apart, I found the 
simple cog system powered by a 
DC motor that moves the hammer 
and pushes one card forward into a 
slot, creating a new stack of cards. 
This would be the inspiration for 
the servo and wheels needed to 
accomplish the automation.” 


Box of bricks 

Michael turned to LEGO for 

the main structure due to its 
versatility. It allowed him to easily 


another script to send the images 
to Amazon’s cloud computing web 
service S3, for storage and to tackle 
image processing. 

“T originally tried Tesseract 
and OpenCV for optical character 
recognition, but I spent a lot 
of time trying to get so many 
variables perfect and I couldn’t get 
consistency,” he explains. To fix 
this, he turned to Amazon’s deep 
learning-based image analyser, 
Rekognition (magpi.cc/sfLJLE), 
which extracts text and indexes a 
collection. “It works well. I did not 
have to worry about getting the 
angle just right, making sure the 


The idea was to make light 
work of organising and valuing 
even the largest of collections 


build, modify, and tear down his 
project. He placed servos in the 
back of the build and had them 
spin continuously. Carefully 
positioned LEGO tyres then move 
forward in a cog-like setup to get 
the cards into position. 
Once the device was built and 
he was happy, Michael could then 
start coding, which he says was 
the easiest part of the build. He 
used Python 2.7 to program a 
script to power both the servos 
and take a picture via a Raspberry 
Pi Camera Module. He then wrote 
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lighting was perfect, or performing 
any machine learning ~- it worked 
despite all of those factors.” 

Apart from issues deciphering 
some fonts, it performed well: 619 
of the 920 cards scanned perfectly 
and he was able to feed the data 
through TCGPlayer.com’s price 
data API to determine the value of 
each card and, therefore, his MTG 
collection. “I had about $275 worth 
of commons, uncommons, and 
rares,” he says, pleased as punch. 
“And through trial and error, I also 
learned a lot along the way.” 
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Quick 


> The doll's 
house took 
ten weeks to 
design and 
prototype 


> APi 3 reads 
information 
from a motion 
sensor 


> ‘MYHouse' is 
short for ‘Maks 
and Yi Fan's 
house’ 


> All the code 
can be found at 
magpi.cc/ 
GnJNjN 


> Machine 
learning is used 
to ‘train’ the 
gestures 
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There's even a mini TV that q 
you can turn on and off - 
pi 


| 
kst 


4 


A PlayStation Move controller 
is used as the magic wand! 


PROJECT 


The speed of the 
ceiling fan is set by two 
finger-rotating gestures 


This smart doll’s house features gesture recognition. 
Nicola King takes a look inside... 


hen a master’s degree 
course at the University of 
Washington required the 
use of sensors and machine learning 
in the same project, two students 
- Maks Surguy and Yi Fan Yin - 
conceived the idea of an interactive 
doll’s house. Inside this cool crib, 
various features — including lighting 
and shutters — can all be turned 
on and off by the simple wave 
of a ‘wand’ (a PlayStation Move 
controller), with the help of some 
clever coding and a Raspberry Pi 3. 
You can see a demonstration video 
at youtu.be/6EiTWZfPm3k. 
“I thought a smart doll’s 
house would be a great tool to 


demonstrate technical innovations 
to people in an approachable way,” 
says Maks, who worked with Yi Fan 
over a ten-week period, designing 
and constructing the clever little 
doll’s domicile. 

After consulting Maks’s architect 
wife about the physical structure, 
the pair drew the plans in 3D 
modelling software, then fitted 
together cardboard pieces for a 
prototype. Once happy with the 
design, they laser-cut the pieces 
out of plywood, made use of 
snap-fit to join them, then painted 
them in different colours. 
According to Maks, building a 
doll’s house is akin to building 


areal house. “Lots of decisions 
needed to be made about 
dimensions, colours, structure, 
function, and interactions between 
all elements of the dollhouse. We 
ended up simplifying a lot of the 
elements through iterative process 
after realising that what we 
envisioned is actually a lot harder 
than it seems. Thankfully we had 
24/7 access to a makerspace here 
in school and were able to reach 
decisions through prototyping 
every aspect of the construction.” 


Grand gestures 
A key characteristic of this smart 
doll’s house is its ability to 
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recognise gestures and respond 
accordingly. Having done a great 
deal of research into gesture 
recognition, “trial and error went 
into choosing what gestures 
perform best across individuals 
while remaining intuitive to most 
people,” says Maks. “We read a 
lot of research papers on gesture 
recognition and then came up with 
our own gestures that worked with 
over 90 percent accuracy.” 

In total, seven gestures — 
pre-trained using machine 
learning — are stored in the 
system, and the Raspberry Pi 
reads the information from 
the PlayStation Move and then 
determines if the gesture is 
similar to one of the stored ones. 


The machine learning aspect of 
the project also presented certain 
challenges, as Maks recalls: “We 
ran into trouble selecting the 
most intuitive gestures and had 
to do quite a bit of trial and error 
to refine the experience. It takes 
about 20 samples per gesture 
to train the neural network, 
which is doable in a matter 
of a few minutes.” 


Possibilities of Pi 

Maks was keen to use a 
Raspberry Pi in this project as 

he is enthusiastic about the 
possibilities it presents: “Iam 
interested in pushing the Pi to its 
limits.” He also has plans for the 
future, currently working with 


J lam interested in pushing 
the Pi to its limits 


As Maks explains, if the gesture 
is recognised, “various functional 
items in the dollhouse can be 
activated or deactivated using 
these pre-trained gestures: TV, 
lights, fan, and shutters.” 


>STEP-01 

Plywood structure 

After constructing a cardboard 
prototype, the doll's house was 
built from laser-cut plywood 
pieces which snap together. 
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the Processing Foundation as a 
part of Google Summer of Code 
initiative to reduce barriers in 
using the Processing language on 
the Raspberry Pi. “My plan is to 
create a comprehensive resource 


MY House overview 


Bluetooth 


-=--> 


i Raspberry Pi e, i 
N X 
PSMove Controller 0, Vv | 
Machine Learning “&, is U e 
Intuitive Gestures + J 


Actuation P ` 


N LEDs 


Shutters 


that teaches people of all ages 
how to use the Raspberry Pi 
and Processing together, taking 
advantage of all connectivity and 
interactivity available on the Pi.” 
If the idea of an interactive doll’s 
house appeals, the open-source 
nature of the code that Maks has 
created means that this is a build 
that anyone can attempt, as long 
as they possess some coding skills 
and the necessary components. 
“We haven’t released the building 
plans for the dollhouse yet but if 
somebody’s interested, I can share 
those as well,” says Maks. 


Pi 3 reads the 
gestures and 
controls all the 


in the house 


>STEP-02 


NeoPixel letters 


Above A Raspberry 


electronic devices 


The laser-cut M and Y letters are each 


fitted with a strip of NeoPixel LEDs. 
Servos are used to rotate the ceiling 
fan and open the shutters. 


>STEP-03 
Gesture training 
Maks and Yi Fan researched the most 


intuitive gestures to use. Each gesture 
was trained using a neural network, which 


involved taking around 20 samples. 


July 2018 MagPi 


> It took three 
months to 
design and 
build the robot 


2 Both Python 
and Processing 
are used 


> View a video 
of it in action 
at magpi.cc/ 
JXhmpT 


> See Cadin's 
latest comics 
on Instagram 
@cadinb 


> He'd like to 
make a themed 
comic version 
of the robot 
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Due to a lack of 
space inside the 
robot body, Cadin 
used a right-angled 
USB plug for the 


A tiny robot designed to make you 
smile? Nicola King sees the funny 
side of robotics 


printer connection 


adin Batrack enjoys 
creating his own small 
comics, and likes to 
publish a new one every day on 
his Instagram account (@cadinb). 
Having decided to create a program 
to randomly generate high- 
resolution comics, he was inspired 
to take things a step further. 
“Shortly after starting that 
project, I was invited to participate 
in a local comic show,” Cadin 
tells us. “I wanted a way to show off 
the random comic software at my 
booth, to let people generate and 
print a custom comic to take with 
them. The obvious solution was 
to build a little yellow robot that 
vomits comics out of his mouth.” 


The case is 
constructed from 
laser-cut plywood 


Press this button to 
generate a comic 


Out of the mouths 

of robots 

Having created the random comic 
software using the Processing 
anguage, Cadin chose to use a 
Raspberry Pi3 to run this anda 
Python script. The latter controls the 
robot’s LEDs, handles push-button 
input, and sends the comic images 
to a mini thermal printer connected 
to the Pivia USB. Cadin madea 
aser-cut plywood casing to hold all 
of the components, and the amusing 
ittle ‘Vomit Comic Robot’ was born. 


A thermal receipt 
printer produces 
the comic 
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VOMIT COMIC ROBOT 


Projects 


When the robot’s button is 
pressed, the Python script sends a 
message to the Processing sketch. 
“The sketch generates a random 
comic layout, and chooses some 
of my drawings to populate the 
frames,” explains Cadin. “It 
chooses at random from about 100 
drawings. Each image has some 
associated data that informs how it 


According to Cadin, the project 
could easily be replicated using 
his comic-generating code 
(magpi.cc/tOYOcL), and makers 
can add their own drawings. “If 
you wanted to print something 
else (not random comics) it 
would be even easier, because you 
could leave out the Processing 
sketch entirely.” 


MAKING A VOMIT 
COMIC ROBOT 
aaa 


Bo 


Ose 


I would like to make a version that 
lets you choose a theme for your 
comic, like ‘food’ or ‘animals’ 


should be composed within a comic 
frame. The final composite image 
is saved to the Pi’s SD card.” 

The Python script then loads the 
image and sends it to the printer. 
“With each comic I also print the 
date, the comic number, and the 
name of the event.” 


The robot that gags... 
gags, geddit? 

Cadin hopes to tweak the robot in 
the future: “I would like to make 

a version that lets you choose a 
theme for your comic, like ‘food’ 

or ‘animals’ or ‘nature’. I imagine 
a big dial on the robot that lets you 
select the theme and then you get a 
comic with images from that theme 
when you press the button.” 


Creating comics 

Cadin first created the random comic generation 
software using the Processing language. You can find 
his code on GitHub at magpi.cc/tOYOcL. 


Cadin has received a lot of 
positive feedback on his humorous 
hack, but says he isn’t sure that 
people really understand what 
is happening inside the robot: 

“Tt would be nice if they could 
somehow see the comics being 
generated to understand that 
it’s happening dynamically, 
and not just printing out a 
pre-made comic.” 

Some people have suggested 
adding more narrative to the 
comics, but Cadin isn’t sure: “I like 
that they come out as nonsense... 
He’s not a very smart robot!” 

Vomit Comic Robot may 
not be smart, but this is one 
quipster guaranteed never to get 
stage-fright. 


Connecting the components 
All the software runs on a Raspberry Pi 3. Its GPIO 
pins are connected to a push-button, status LEDs, 


Each printout 
features details 
including the event 
name and date 
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and the thermal printer. 


The final build 

Laser-cut plywood was used to construct the robot's 
body. Cadin admits he made it slightly too small, so 
had to make some adjustments inside. 
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Tutorial 


BUILD AN 


Make your ovyn oscilloscope using a Raspberry Pi and an Arduino 


You'll 


Need he oscilloscope is on the wish list of anyone to £5000 and beyond. However, by using an Arduino 


starting out with electronics. Your author and some software on the Raspberry Pi, you can make 
eae used to tell his students that it was your eyes, a passable beginner’s oscilloscope. 
> Uno, Nano, . Poe i anë à Ë 
Mega or any making electricity visible. Unfortunately, they are Last September, in The MagPi #61, there was an 
AVR-based quite expensive: from a few hundred pounds to up article outlining the way the Raspberry Pi and the 
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N Schematic 
To Raspberry Pi of the Arduino 
BNC Input Socket USB acquisition module 


Arduino could be used together. We at the Bakery 
have been doing this for some time: we first had a 
major project in the Raspberry Pi Projects books by 
Andrew Robinson and Mike Cook. The big advantage 
of the Arduino from a signal processing point of 
view is that there is minimal interruption from 


the operating system and you can gather data ata >STE P-01 

constant uninterrupted rate. This is just what we Gathering the parts 

need for making an oscilloscope. The idea is that the 

Arduino gathers a whole heap of voltage samples We used an Arduino Nano and soldered the header pins to 
as fast as it can and stores it in memory. It then it. Then we took a 14 hole by 19 strips piece of stripboard and 


drilled some holes to fix it to the base of the box. You might 
want to make this longer than 19 strips if you are not using 
surface-mount resistors on the underside. Fit header sockets 
to the stripboard and break the tracks on the underside 
between the two rows. 


transfers that memory to the Raspberry Pi, again as 
fast as possible. The Pi plots the data and displays it, 
then the software allows measurements to be made 
on the samples. 

So you can measure the time and voltage 
difference, known as a delta, between any two points 
on the samples. You can even display the frequency 
that the ‘time delta’ corresponds to by taking its 
reciprocal. These are features found in expensive 
oscilloscopes. We have also built in a trigger 
function, this is to synchronise the onset of the rapid 
data gathering with the occurrence of a positive 
transition on the input signal through a specified 
voltage. The result is that regular waveforms can look 
stable on the display. 


The hardware 

The schematic of the Arduino data acquisition 
module is shown in Figure 1. You will notice that it is 
quite simple. It consists of three potentiometers for 
the oscilloscope’s controls and an AC coupled biased 
voltage input. The capacitor ensures that no DC 
components from the input get through and gives a 
modicum of protection for overvoltage. The reference 
voltage, or ground, is similarly biased as +2.5 V above 
the Pi’s ground level. The use of a BNC socket for 

the input ensures that you can use this with proper 
oscilloscope probe leads; these normally have an X10 


Tutorial 


switchable attenuator fitted, thus allowing voltages 
of +/- 25V to be measured. Full construction details 
can be found in the numbered steps. 


Arduino software 

The software, or sketch, you need to put into the 
Arduino is shown in the Gather_Ao.ino listing, 

and is quite simple. Normally an Arduino of this 
type will take samples at a rate of 10000 per second 


It proved to be a lot more 
tricky to write than we 
first imagined 


- or as we Say, a 10k sample rate. This is not too good 
for an oscilloscope, but we can increase this sample 
rate by speeding up the A/D converter’s clock speed 
from the default rate. It does not appear to affect the 
reading accuracy too much. By making this change, 
we can speed up the sample rate to 58k. This is much 


>STEP-02 


Adding access holes 


The BNC socket has a flat on each side of the 
thread, this is to prevent it rotating with the 
twisting force it will be subjected to upon 
connecting any probe. We did this by first 
drilling an 8mm hole for the flats and then 
enlarging the hole with a circular file on each 
side to allow it to fit. An 8x12 mm hole was filed 
opposite the USB connecter to allow access. 


better and allows useful measurements to be made 
in the audio range. 

So, first, the trigger function is optionally called 
and then the samples are gathered in and sent to the 
Pi. The trigger function has a time-out which means 
it will trigger anyway after one second, whether it 
sees a transition on the input signal or not. Then the 
three pots are measured and also sent to the Pi. Note 
here that the samples are ten bits wide and so have to 
be sent as two bytes that get joined together again in 
the Pi’s software. 

Also note the use of the double read for the pots, 
with a bit of code between each. This ensures a 
more stable reading as the input capacitor of the 
Arduino’s sample and hold circuit needs time to 
charge up, and it has less time than normal to 
do this due to the speeding up of the D/A. It does 
not effect the waveform samples too much as in 
most waveforms one sample voltage is close to the 
previous one. 

At the end of the transfer, the Arduino sits ina 
loop waiting for an acknowledge byte from the Piso 
it can start again. This acknowledge byte also carries 


X 


= 
GMP 02 D404, DË D 
` E 2 4 


Voltage A3 


oV 


>STEP-03 
Wiring the pots 


We then drilled three holes for the pots, and 
added the small slots for the anti-rotation lugs. 
Then we fitted the pots and wired them up using 
the diagram above. This is the view from inside the 
lid of the box; if you're worried about touching the 
side of the box with your soldering iron, consider 
soldering them before attaching to the box. 


the information as to whether to use a trigger or not 
on the next sample. 

Finally, before each buffer full of data is gathered, 
pin 13 on the board is lit, and turned off after. This is 
so that we could time the process on a commercial 
oscilloscope to find the sample rate - something you 
vvill not have to do if you use the recommended AVR- 
type Arduinos running at 16MHz. 


Pi software 

The software for the Raspberry Pi is written in 
Python 3 and used the Pygame framework. It proved 
to be a lot more tricky to write than we first imagined, 
and is shown in the Scope.py listing. Python 3 uses 
Unicode characters by default, and allowed us to 
display the delta (A) and mu (u) Greek characters for 
the difference and the time. The code first sets up the 
non-display part of the window, this is only drawn 
once and then parts of it are updated when necessary. 
Depending on what type of Arduino you have, it can 
show up as a different USB port; we found that ours 


Li Voltage 
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>STEP-04 


Finishing off 


Add the resistors and capacitors to the 
stripboard and wire up the BNC socket. Solder 
this up before mounting, otherwise you will 
melt the plastic. Remember to thread the 
central wire through the ground washer, 
crinkle washer, and nut before soldering 

it. Add labels Trigger, Time, and Volts to 

the knobs. 
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Figure 2 Taking measurements on a swept signal 


showed up as one of two ports. Comment out which 
one is not applicable when defining the sampleInput 
variable at the start of the listing. 

Finally, we cobbled together a 168x78 pixel logo 
for the top-left corner, using a piece of clip art 
and fashioning the word ‘Oscilloscope’ from an 
outlined version of the Cooper Black font. We called 
it PyLogo.png and placed it in an images folder next 
to the Python code. 


Using the oscilloscope 

The oscilloscope samples at 58 kHz, which in theory 
means you can measure waveforms at 29 kHz. But 
that only gives you two samples per cycle and as 

the samples can be anywhere on the waveform, 
they do not look very good. As a rough guide, you 
need at least ten points on a waveform to make it 
look like a waveform, so that gives a top practical 
frequency of 5.8 kHz. However, by using the Time 
Magnify options along with the freeze function, you 
can measure much higher frequencies. The time and 
voltage cursor lines let you find out the values on 
any point of the waveform, and by clicking the save 
functions the current cursor is replaced by a dotted 
line which is fixed, and measurements can be made 
relative to that. The oscilloscope in action can be 
seen in Figure 2. Note that pressing the S key on the 
keyboard produces a screen dump of the display. 


Taking it further 

There are lots of ways you can take this project 
further. A simple upgrade would involve you having 
a second data buffer to allow you to display a saved 
waveform to compare against the current live one. 
You could also add a lower speed acquisition mode 
to see slower waveforms. You can go the other 

way and use a faster Arduino so you can see the 
higher frequencies. This oscilloscope is AC coupled; 
you could add a DC coupling option with a switch 
potential divider and amplifier to the front end to 
extend the range of voltages you can measure. All 
these improvements, however, will need changes to 
the software to allow the measuring to take place on 
these wider-range parameters. 
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Gather A0.ino 


int buffer [512]; // 1K input buffer 
int sample, lastSample; 
int pot1, triggerVoltage; 


pa 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 
035. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 


057. 


int triggerTimeout = 1000; // time until auto trigger 
unsigned long triggerStart; 
char triggerType = '2'; 


void setup(){ 
Serial. begin(11520@) ; 
pinMode(13, OUTPUT) ; 
// set up fast sampling mode 
ADCSRA = (ADCSRA & Oxf8) | @x04; // set 16 times division 


} 


void loop(){ 

if( triggerType != '2') trigger(); // get a trigger 

digitalwWrite(13,HIGH);// timing marker 

for(int i=0; i<512 ; i++){ 
buffer[i] = analogread(0): 

) 

digitalWrite(13,LOW); // timing marker 

poti = analogRead(2); // switch channel to cursor pot 

for(int i=0; i<512 ; i++){ 
Serial.write(buffer[i]>>8); 
Serial.write(buffer[i] 8 Oxff); 

) 

// send back pot values for cursors 

poti = analogRead(2); 

analogRead(3); // next cursor pot 

Serial.write(poti>>8) ; 

Serial.urite(poti 8 Oxff): 

poti = analogRead(3); 

triggerVoltage = analogRead(4); 

Serial .write(poti>>8) ; 

Serial.write(poti & Oxff); 

triggerVoltage = analogRead(4); 

poti = analogRead(@); // prepair for next sample run 

Serial .write(triggerVoltage>>8) ; 

Serial.write(triggerVoltage 8 Oxff); 


while(Serial.available() == @) { } // wait for next request 
triggerType = Serial.read(); // see what trigger to use 
while (Serial.available() != 0) { // remove any other bytes 
in buffer 
Serial.read(); 


void trigger(){ 

// trigger at rising zero crossing 

triggerStart = millis(); 

sample = analogRead(@); 

do { 

lastSample = sample; 

sample = analogRead(@); 

) 

while(!(lastSample < triggerVoltage 88 sample 
> triggerVoltage) && (millis() - triggerStart < 
triggerTimeout) ); 
) 
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002. 
003. 
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005. 
006. 
007. 


008. 
009. 
010. 
011. 


012. 
013. 


014. 
015. 


016. 
017. 


018. 


019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 


031. 


032. 
033. 
034. 
035. 


036. 
037. 
038. 
039. 
040. 


041. 
042. 
043. 
044. 
045. 
046. 
047. 


Cope py 


import serial, pygame, os, time 


pygame.init() 

os.environ['SDL_VIDEO_WINDOW_POS'] = 'center' 
pygame.display.set_caption("Arduino / Pi Oscilloscope") 
pygame.event.set_allowed(None) 
pygame.event.set_allowed( [pygame .KEYDOWN, pygame. 
MOUSEBUTTONDOWN, pygame.QUIT, pygame.MOUSEBUTTONUP ] ) 


textHeight=20 ; font = pygame.font.Font(None, textHeight) 
screenWidth = 720 ; screenHight = 360 

screen = pygame.display.set_mode([screenWidth, 
screenHight], 2,32) 

display = pygame.Surface((512,256)) 


backCol = (150,150,100) ; black = (0,0,0) # background 
colours 

pramCol = (200,200,150) # parameter colour 

logo = pygame. image. load("images/PyLogo.png").convert_ 


alpha() 


sampleInput = serial.Serial("/dev/ttyUSB0",115200e, 
timeout = 5) # For Mega or nano 

#sampleInput = serial.Serial("/dev/ttyACMe", 115200, 
timeout = 5) # For Uno 


displayWidth = 512 ; displayHight = 256 

LedRect = [ pygame.Rect((0,0),(0,0))]*17 

inBuf = [@]*512 # quick way of getting a 512 long buffer 
choff = displayHight//2 # Channel Offset 

run = [True,False,False,True,False] # run controls 
expandT = 1 ; expandV = 1 # voltage & time expansion 


sampleTime = 17 # uS for 58KHz sample 

smples_cm = 32 * sampleTime 

volts_sample = 5/1024 # volts per sample 

measureTime = False ; measureVolts = False;savedTime = 
Q;savedVoltage = 0 

cursorT = 8: cursorV = 0; vMag = 1; svLed = False; 
stLed = False 

triggerC = 512 ; savedVoltsC = -1 ; savedTimeC = -1 


def main(): 
pygame. draw. rect (screen, backCol, (8,0,screenWidth, 
screenHight+2) ,@) 
defineControls() 
drawControls() 
time.sleep(@.1) 
sampleInput.flushInput() # empty any buffer contents 
sampleInput.write(b'2') # tell Arduino to get a new 
buffer 
while(1): 
time.sleep(@.001) # let other code have a look in 
readArduino() # get buffer data 
plotWave() # draw waveform 
if measureTime or measureVolts : 
updateControls(True) 
drawScope() # display new screen 
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048. 
049. 


050. 
051. 
052. 


053. 
054. 


055. 
056. 
057. 


058. 
059. 


060. 
061. 


062. 
063. 
064. 
065. 
066. 
067. 
068. 
069. 
070. 
071. 
072. 
073. 
074. 


075. 
076. 
077. 
078. 
079. 
080. 
081. 


082. 
083. 
084. 
085. 
086. 
087. 
088. 
089. 
090. 


091. 
092. 


093. 
094. 


checkForEvent() 
while run[4]: # if in 
hold mode wait here 
checkForEvent() 
if run[3]: 
sampleInput.write(b'1') 


>PYTHON 3 


DOWNLOAD: 
magpi.cc/1NqJjmV 
# tell Arduino to get an other 


buffers 
else: 


PROJECT 
VIDEOS 


sampleInput. 
write(b'2') # buffer but no 
trigger 


Check out Mike's 
Bakery videos at: 
magpi.cc/DsjbZK 


def drawGrid(): 
pygame. draw. rect (display, (240, 240, 240), (0,0, 
displayWidth, displayHight) , 2) 
for h in range(32,256,32): # draw horizontal 
pygame. draw. line(display, (120,120,120),(@,h), 
(512,h),1) 
for v in range(32,512,32): # draw vertical 
pygame.dravn. line(display,(120,120,120),(v,0), 
(v,256),1) 
pygame.drav. line(display,(2,0,0),(256,0),(256,256),1) 
pygame.dran.line(display,(90,0,0),(9,128),(512,128),1) 


def drawControls(): 
drawWords("Time Magnify”,10,360,black ,backCol) 
drawWords("Voltage Magnify", 220, 300,black, backCol) 
drawWords("Measure" , 440, 300, black, backCol) 
drawwWords("Time" ,440, 320, black, backCol) 
drawwWords("Volts",486, 320, black, backCol) 
drawwWords("Save", 540,300, black, backCol) 
drawwWords("Time" ,540,320, black, backCol) 
drawwWords("Volts",586,320,black,backCol) 
drawWords("1/"+chr(@x394)+"Time",540,257,black, 

backCol) 
drawwWords(chr(@x394)+"Time", 540,237, black, backCol) 
drawWords("Saved Time",54@,217, black, backCol) 
drawWords("Time",540,197, black, backCol) 
drawWords(chr(@x394)+"Voltage" , 540,167, black, backCol) 
drawWords("Saved Voltage" ,540,147,black,backCol) 
drawwWords("Voltage",54@,127, black, backCol) 
drawWords("Run Single Freeze Trigger", 

540,77,black, backCol) 
screen.blit(logo, (540,2)) 
updateControls (True) 


def updateControls(blank): 
global vDisp 
if blank: 
pygame. draw. rect (screen ,backCol, resultsRect,0) 
if expandT*smples_cm >= 1000: 
drawWords("Time "“+str((expandT*smples_cm)//10@0) 
+"mS per division ",10,280,black, backCol) 
else: 
drawWords("Time "“+str(expandT*smples_cm)+ 
"uS per division ",10,280, black, backCol) 
volts_cm = int(volts_sample*128*1000/expandV) 
drawWords("Voltage "+str(volts_cm)+"mV per division", 
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095. 
096. 


097. 
098. 
099. 


100. 
101. 
102. 
103. 
104. 
105. 
106. 
107. 
108. 
109. 


110. 


111. 


112. 
113. 


114. 
115. 


116. 
117. 


118. 


119. 


120. 
121. 
122. 
123. 
124. 
125. 
126. 
127. 
128. 
129. 
130. 
131. 
132. 
133. 


134. 
135. 
136. 
137. 
138. 
139. 
140. 


220,288 ,black ,backCol) 
for n in range(98,6): # time option LED 
drawWords("x"+str(1<<n),10+n*30,320,black, 
backCol) 
drawLED(n,expandT == 1<<n) 
for n in range(6,9): # voltage options 
drawWords("x"+str(1<<(n-6)),220+ 
(n-6)*30,320,black, backCol) 
drawLED(n,expandV == 1<<(n-6)) 
drawLED(9,measureTime) 
drawLED(10,measureVolts) 
drawLED(11, stLed) 
drawLED(12,svLed) 
for n in range(13,17): 
drawLED(n,run[n-13]) 
if measureTime : 
t = (cursorT>>1)*sampleTime / expandT 
drawWords(" "+trunk(t,5)+" "“+chr(@x3bc)+"S",640, 
197,black,pramCol) # current time 
drawWords(" "+trunk(savedTime,5)+" "+chr(@x3bc)+ 
"S",640,217,black, pramCol) 
drawWords(" "+trunk(t-savedTime,5)+" "+chr(@x3bc) 
+"S" ,640,237,black,pramCol) # delta time 
if t-savedTime != 0: 


drawWords((trunk(10@000@ / abs(t-savedTime),5)) 


+" Hz" ,640,257,black, pramCol) 
if measureVolts : 

vDisp = (((1024-cursorV)>>2)-128)*volts_sample * 
vMag 

delta = vDisp - savedVoltage 

drawWords(" "+trunk(delta,4)+ 
"Vv", 640,167, black, pramCol) 

drawWords(" "+trunk(savedVoltage, 4)+ 
"Vv", 640,147, black, pramCol) 

drawWords(" "+trunk(vDisp,4)+ 
"Vv", 640,127, black, pramCol) 


def trunk(value, place): # truncate a value string 
v=str(value)+" 900000" 
if value>@: 
v = v[@:place] 
else: 
v = v[@:place+1] # extra place for the minus sign 
return v 
def drawLED(n,state): # draw LED 
if state : 
pygame. draw. rect (screen, (240,0,0),LedRect[n],®) 
else : 
pygame.draw. rect (screen, (240,240,240), 


LedRectin),0) 


def defineControls(): 
global LedRect, resultsRect 
for n in range(@,6): 
LedRect[n] = pygame.Rect ((10-n”30,336),(15,15)) 
for n in range(6,9): 
LedRect[n] = pygame.Rect((220+ 
(n-6)*30, 336), (15,15)) 
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141. 
142. 
143. 


144. 


145. 
146. 
147. 
148. 


149. 
150. 
151. 
152. 
153. 
154. 
155. 
156. 
157. 
158. 
159. 
160. 
161. 
162. 
163. 
164. 


165. 
166. 
167. 
168. 
169. 


170. 
171. 
172. 


173. 
174. 


175. 
176. 
177. 


178. 
179. 
180. 
181. 


182. 
183. 
184. 
185. 
186. 
187. 
188. 
189. 
190. 


LedRect[9] = pygame.Rect((440,336),(15,15)) # time 
LedRect[10] = pygame.Rect((486,336),(15,15)) # volts 
LedRect[11] = pygame.Rect((540,336),(15,15)) # save 
time 
LedRect[12] = pygame.Rect((586,336),(15,15)) # save 
volts 
LedRect[13] = pygame.Rect((545,100),(15,15)) # run 
LedRect[14] = pygame.Rect((580,100),(15,15)) # single 
LedRect[15] = pygame.Rect((628,100),(15,15)) # freeze 
LedRect[16] = pygame.Rect((676,100),(15,15)) tt 
trigger 
resultsRect = pygame.Rect((639,125),(90,153)) 
def plotWave(): 


global vMag 
lastX=0 ; lastY=0 
vMag = 2 # adjust voltage scale 
if expandv 
vMag = 4 
if expandV == 4: 
vMag =1 
drawGrid() 
s = © # sample pointer 
for n in range(@, displayWidth, expandT): 
y = (512-inBuf[s])//vMag + choff 
if n != 0: 
pygame. draw. line(display, (0,200,@), 
(lastX ,lastY), (n ,y ),2) 


lastX =n 
lastY = y 
S t= 1 


if measureTime : 
pygame. draw. line(display, (0,0,255), 
(cursorT>>1,0), (cursorT>>1,256),1) 
if savedTimeC != -1: 
for n in range(@,256,12): 
pygame. draw. line(display,(9,0,255), 
(savedTimeC,n), (savedTimeC,n+6) ,1) 
if measureVolts : 
pygame. draw. line(display, (255,0,@), 
(@,cursorV>>2), (512,cursorV>>2),1) 
if savedVoltsc != -1: 
for n in range(@,512,12): 
pygame.draw. line(display, (255,0,@), 
(n, savedVoltsC), (n+6,savedVoltsC) ,1) 
if run[3] : # use trigger 
y = (triggerc-512)//vMag + chOff 
for n in range(@,512,12): 
pygame. draw. line(display, (255,128,0),(n,y), 
(nt6,y),1) 


def drawScope(): # put display onto scope controls 
screen.blit (display, (10,10) ) 
pygame. display.update() 


def drawWords(words,x,y,col,backCol) : 
textSurface = font.render(words, True, col, backCol) 
textRect = textsurface.get rect() 
textRect.left = x 
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191. textRect.top = y 241. if LedRect[14].collidepoint(pos): # single 
192. screen.blit(textSurface, textRect) 242. run[1] = True 
193. 243. run[@] = False 
194. def readArduino(): # get buffer and controls 244. run[2] = False 
195. ae A a E. A dj 245. run[4] = True 
196. i muntai: #if in freeze mode funnel data into jun 246. pda cecon ole (Palee) 
197. for i in range(0,1024): me a 
198. junk = sampleInput.read() j : RUE 8 . 
199. lete më Gaan ea ketit Sime Sha RA 248. if LedRect[15].collidepoint(pos) and not run[1]: # 
200. for i in range(0,512): freeze 
201. inBuf[i] = ((ord(sampleInput.read())) << 8) | 249. run[2] = not(run[2]) 
ord(sampleInput.read()) 250. if not run[2]: 
202. cursorT = ((ord(sampleInput.read())) << 8) | 251. run[@] = True 
ord(sampleInput.read()) 252. else: 
203. cursorV = 1024 - (((ord(sampleInput.read())) << 8) | 253. runjej = False 
E )) 254. if LedRect[16].collidepoint(pos): # trigger 
204. triggerC = 1024 - (((ord(sampleInput.read())) << 8) | 255. Amie’) = Gee 
ord(sampleInput.read())) 
K F 256. updateControls(False) 
205. if run[1]: #single sweep requested 
206. run[1] = False 257 
207. run[2] = True # put in freeze mode 258. def handleMouseUp(pos): # look at mouse up 
208. updateControls (True) 259. global savedVoltage,savedTime, svLed, stLed, run 
209. 260. if LedRect[12].collidepoint(pos) and measureVolts: 
210. def handleMouse(pos): # look at mouse down 261. savedVoltage = vDisp 
211. global expandT,expandV,measureTime,measureVolts,svLed, 262. svLed = False 
stLed 263. updateControls(False) 
212. global savedVoltsC, savedTimeC, run 264. if LedRect[11].collidepoint(pos) and measureTime: 
213). al ae 265. savedTime = (cursorT>>1)*sampleTime / expandT 
214. orin in range(@,6) y 266. e e 
215. if LedRect[n].collidepoint(pos): 
216 SE iken 267. updateControls(False) 
217 for n in range(6,9) : 268. if LedRect[14].collidepoint(pos): # single 
6 SED B 
218. if LedRect[n].collidepoint(pos): 269. run[4] = False 
219. expandV = 1<<(n-6) 270. updateControls(False) 
220. if LedRect[9].collidepoint(pos): #toggle time 271. 
measurement 272. def terminate(): # close down the program 
221. measureTime = not(measureTime) 273. pygame.quit() # close pygame 
222. if not measureTime : 274. os. exit(1) 
223. savedTimeC = -1 275. 
224. I edRect rren cor on 276. def checkForEvent(): # see if we need to quit 
225. measureVolts = not(measureVolts) # toggle volts 
277. event = pygame.event.poll() 
measurement y 
226. Ea ef TEENS E 278. if event.type == pygame.QUIT : 
227. savedVoltsC = -1 HE) e 
228. if LedRect[11].collidepoint(pos) and measureTime: # 280. if event.type == pygame.KEYDOWN : 
save time 281. if event.key == pygame.K_ESCAPE : 
229. stLed = True 282. terminate() 
230. savedTimeC = cursorT>>1 283. if event.key == pygame.K_s : # screen dump 
231. if LedRect[12].collidepoint(pos) and measureVolts: # 284. os.system("scrot -u" 
save volts 285. if event.type == pygame.MOUSEBUTTONDOWN : 
2323 svLed = True 286. handleMouse(pygame.mouse.get_pos()) 
233. payed ae Ren Pe që 287. if event.type == pygame.MOUSEBUTTONUP : 
234. # run controls logic 288 SE i t 
235. if LedRect[13].collidepoint(pos) and not run[1]: # run i naen EUO pye ame mous Basis) 
236. run[@] = not(run[@]) 282 
237. if not runlo): 290. 
238. run[2] = True 291. # Main program logic: 
239. else: 292. if name == ' main i) 
240. run[2] = False 2936 main() 
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Tutorial STEP BY STEP 


GET STARTED WITH 
PYGAME ZERO 


Pygame Zero is a great choice for anyone who wants to start writing 
computer games on the Raspberry Pi 


f you’ve done some Python coding and wanted > STEP-01 


Raspbian Jessie to write a game, you may have come across Loading a suitable program editor 
SO Pygame. The Pygame module adds many The first really labour-saving thing about Pygame 
An image | functions that help you to write games in Python. Zero is that you can write a program in a simple text 
alae Pygame Zero goes one step further to let you skip over editor. For the easiest route we suggest using the IDLE 
as GIMP the cumbersome process of making all those game Python 3 editor, as Pygame Zero needs to be formatted 
A little loops and setting up your program structure. You like Python with its indents and yov’ll get the benefit 
imagination don’t need to worry about functions to load graphics of syntax highlighting to help you along the way. 
A keyboard or keeping data structures for all the game elements. So the first step in your journey will be to open the 
If you just want to get stuck in and start making Python 3 IDLE editor from the Raspbian main menu, 
things happen on the screen without all the fluff, then under Programming. You’ll be presented with the 
Pygame Zero is what you need. Python Shell window. 
The Python Shell 
window that Lë Python 3.53 Shell .12¢21.py- /home/pi/..|Eoi@raspbenypi: ~/p- 
appears when Python 3 -50x 
bë Pas TEET et E e 
Ee 3.0 20470134) on dë iF on 


itive "copyright", mu redita” or “license()” for more informat f 
Our program $ 
listing. This is a file 
window from the 
IDLE application 


poa RESTART: /home/pi/ygamezero.py ===== 


|| trackrighe = () ” 
ganeStatus = Ô 


sot dra): 9 Py 


The Terminal 
window - enter the 
command to run 


Sereen. Hs, em 128)) 
neStatus 

car -draw( ) 

b=0 


while b < leni praskuafë): 
trackteft[b] dram() 
trackRight (oj -draw( ) 


our program : a 1: 
screen. roast ‘3 mg’. (328, 268)) 
if gameStatus == 
: z sereen. bite on ag’, (318, 268)) 
TERMINAL ; E sat pc rine zaro vie function 
see, erackooune 
SHORTCUTS a "Tea: we anet, 
Urë Cok a if keyboard. right 
EErEE E cpaatetrack 


if RrackCount > 200: gameStatus = 2  Chequered flag state 


File Edit Tabs Hel 
Instead of ie ES k of makarrach(): E Function te sk 
pe dhe gra kont, të raciposi ti ion, ses 
H , i tracktefe append(Act n = (trackPosition-trackwi 
retyping trackRighé. appena(actor( Barrier“, pos = {trackPositionstrackwidth, 0))) 
= treakeomt 0 
pgzrun ek): o ts pli dë ar rë ke ee 
racel py in trackoount, yeh og trackDirection, trackwidth, gameStatus 
ki . JA < leni tracklet 
the Terminal f car. scllugerect(vrachets{6) « r car.colliderect(trackRight[b]): 
tëk çeqe vë 
e 4 4 trackLeft[b].y += SPEED 
window, you e y c= SPEED 


trackPosition += 16 
et trackPosition -= 1 


can use the | trackloft[lon{trackteft):1).y > 3 
up arrow to Fadil e, Ya, tracknirection greko ec in 
repeat the last I if, trackBosttton < trackWidth: trackDirection = alse 

command. 


# End of functions 
makeTrack() # Nake first block of track 


int Cok oO 
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>STEP-02 

Writing a Pygame Zero program 

To start writing your first Pygame Zero program, go 
to the File menu of the IDLE Python Shell window 
and select ‘New File’ to open up a new editor window 
- and that’s it! You have written your first Pygame 
Zero program! The Pygame Zero framework assumes 
that you will want to open a new window to run your 
game inside, so even a blank file will create a running 
game environment. Of course at this stage your game 
doesn’t do very much, but you can test it to make sure 
that you can get a program running. 


>STEP-03 

Running your first Pygame Zero program 
With other Python programs, you can run them 
directly from the Python file window. Currently IDL] 
does not support running Pygame Zero programs 
directly, but the alternative is very simple. First of all, 
you need to save your blank program file. We suggest 
saving it as pygame1.py in your default user folder 
(just save the file without changing directory). All you 
need to do then is open a Terminal window from the 
main Raspbian menu and type pgzrun pygame1.py 
(assuming you called your program pygame1.py) and 
hit RETURN. After a few seconds, a window titled 
‘Pygame Zero Game’ should appear. 


>STEP-04 

Setting up the basics 

By default, the Pygame Zero window opens at the 

size of 800 pixels wide by 600 pixels high. If you 

want to change the size of your window, there are 

two predefined variables you can set. If you include 
WIDTH = 700 in your program, then the window will 
be set at 700 pixels wide. If you include HEIGHT = 800, 
then the window will be set to 800 pixels high. In this 
tutorial we’ ll be writing a simple racing game, so we 
want our window to be a bit taller than it is wide. When 
you have set the WIDTH and HEIGHT variables, you could 
save your file as race1.py and test it like before by 
typing pgzrun race1.py into the Terminal window. 


>STEP-05 

Look! No game loop! 

When writing a Python game, normally you would 
have a game loop - that’s a piece of code that is run 
over and over while the game is running. Pygame 

Zero does away with this idea and provides predefined 
functions to handle each of the tasks that the game 
loop normally performs. The first of these we will look 
at is the function draw(). We can write this function 
into our program the same as we would normally 
define a function in Python, whichis def draw():. 
Then, so that you can see the draw function doing 
something, add a line underneath indented by one 
tab: screen. fi11((128, 128, 128)). This is shown 
in the figure1.py listing overleaf. 


m 


raspberrypi.org/magpi 


GET STARTED WITH PYGAME ZERO 


racel.py 


>PYTHON 
from random import randint 

WIDTH = 700 # Width of window 

HEIGHT = 800 # Height of window 

car = Actor("racecar") # Load in the 
car Actor image 
car.pos = 250, 700 
SPEED = 4 
trackCount = 0 
trackPosition = 250 
trackWidth = 120 
trackDirection = False 

trackLeft = I) # list of track barriers left 


DOWNLOAD: 
magpi.cc/VcqutR 


Set the car screen position 


trackRight = [] list of track barriers right 
gameStatus = 0 
def draw(): # Pygame Zero draw function 


global gameStatus 
screen.fill((128, 128, 128)) 
if gameStatus == 9: 
car.draw() 
DAN 
while b < len(trackLeft): 
trackLeft[b].draw() 
trackRight[b].draw() 
b += 1 
if gameStatus == 
# Red Flag 
screen.blit('rflag', (318, 268)) 
if gameStatus == 2: 
# Chequered Flag 
screen.blit('cflag', (318, 268)) 


def update(): # Pygame Zero update function 
global gameStatus , trackCount 
if gameStatus == 9: 
if keyboard.left: car.x -= 2 
if keyboard.right: car.x += 2 
updateTrack() 
if trackCount > 200: gameStatus = 2 # Chequered flag 
state 


def makeTrack(): # Function to make a new section of track 

global trackCount, trackLeft, trackRight, trackPosition, 
trackWidth 

trackLeft.append(Actor("barrier", pos = (trackPosition- 
trackWidth,®))) 

trackRight.append(Actor("barrier", pos = 
(trackPosition+trackWidth, @))) 

trackCount += 1 


def updateTrack(): # Function to update where the track 
blocks appear 
global trackCount, trackPosition, trackDirection, 
trackWidth, gameStatus 
b=@ 
while b < len(trackLeft): 
if car.colliderect(trackLeft[b]) or 
car.colliderect(trackRight[b]): 
gameStatus = 1 # Red flag state 
trackLeft[b].y += SPEED 
trackRight[b].y += SPEED 


b += 1 
if trackLeft[len(trackLeft)-1].y > 32: 

if trackDirection == False: trackPosition += 16 

if trackDirection == True: trackPosition -= 16 

if randint(o0, 4) == 1: trackDirection = not 
trackDirection 

if trackPosition > 70@-trackWidth: trackDirection = 
True 

if trackPosition < trackWidth: trackDirection = 
False 


makeTrack() 


# End of functions 
makeTrack() # Make first block of track 
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Figure 1 To set 

the height and 
width of a Pygame 
Zero window, just 
set the variables 
HEIGHT and WIDTH. 
Then you can fill 
the screen with 

a colour 


figurel.py 


01. WIDTH = 700 

02. HEIGHT = 800 

03. 

04. draw(): 

05. screen. ((128, 128, 128)) 


>STEP-06 

The Python format 

You may have noticed that in the previous step we 
said to indent the screen. fill line by one tab. 
Pygame Zero follows the same formatting rules as 
Python, so you will need to take care to indent your 
code correctly. The indents in Python show that the 
code is inside a structure. So if you define a function, 


Actors in Pygame Zero are 
dynamic graphic objects, 
much the same as sprites 


Right To respond 
to key presses, 
Pygame Zero has 
a built-in object 
called keyboard. 
The arrow key 
states can be read 
with keyboard. up, 
keyboard. down, 
and so on 


THE 
GRAPHICS 


If you use 
PNG files for 


your graphics 
rather than 
JPGs, you can 
keep part of 
the image 
transparent. 
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all the code inside it will be indented by one tab. 

If you then have a condition or a loop, for example an 
if statement, then the contents of that condition will 
be indented by another tab (so two in total). 


>STEP-07 

All the world’s a stage 

The screen object used in Step 5 is a predefined 
object that refers to the window we’ve opened for 
our game. The fill function fills the window with 
the RGB value (a tuple value) provided - in this 
case, a shade of grey. Now that we have our stage 
set, we can create our Actors. Actors in Pygame Zero 
are dynamic graphic objects, much the same as 
sprites in other programming systems. We can load 
an Actor by typing car = Actor("racecar"). This 
is best placed near the top of your program, before 
the draw() function. 


>STEP-08 

It’s all about image 

When we define an Actor in our program, what 

we are actually doing is saying ‘go and get this 
image’. In Pygame Zero our images need to be 
stored in a directory called images, next to our 
program file. So our Actor would be looking for an 
image file in the images folder called racecar.png. 
It could be a GIF or a JPG file, but it is recommended 
that your images are PNG files as that file type 
provides good-quality images with transparencies. 
You can get a full free image creation program 
called GIMP by typing sudo apt-get install gimp 
in your Terminal window. If you want to use 

our images, you can download them from 
magpi.cc/srHWWH. 
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>STEP-09 

Drawing your Actor 

Once you have loaded in your image by defining 
your Actor, you can set its position on the screen. 
You can do this straight after loading the Actor by 
typing car.pos = 250, 5@@to set it at position 
250, 500 on the screen. Now, when the draw() 
function runs, we want to display our race car 

at the co-ordinates that we have set. So, in our 
draw() function, after the screen. fill command 
we can type car.draw(). This will draw our race 
car at its defined position. Test your program to 
make sure this is working, by saving it and running 
pgzrun race1.py as before. 


>STEP-10 

I'm a control freak! 

Once we have our car drawing on the screen, 
the next stage is to enable the player to move 
it backwards and forwards. We can do this with 
key presses; in this case we are going to use the 
left and right arrow keys. We can read the state 
of these keys inside another predefined function 
called update(). We can type in the definition 
of this function by adding def update(): to our 


program. This function is continually checked while 


the game is running. We can now add an indented 
if statement to check the state of a key; e.g., 
if keyboard.left:. 


>STEP-11 

Steering the car 

We need to write some code to detect key presses 
of both arrow keys and also to do something 
about it if we detect that either has been pressed. 
Continuing from our if keyboard. left: 

line, we can write car.x -= 2. This means 
subtract 2 from the car’s x co-ordinate. It 

could also be written in long-hand as 

car.x = car.x - 2. Then, on the next line and 
with the same indent as the first if statement, 
we can do the same for the right arrow; i.e., 

if keyboard.right: car.x += 2. These 

lines of code will move the car Actor left and right. 


>STEP-12 

The long and winding road 

Now that we have a car that we can steer, we 
need a track for it to drive on. We are going to 
build our track out of Actors, one row at a time. 
We will need to make some lists to keep track of 
the Actors we create. To create our lists, we can 
write the following near the top of our program: 
trackLeft = [] (note the square brackets) and 
then, on the next line, trackRight = []. This 
creates two empty lists: one to hold the data about 
the left side of the track, and one to hold the data 
about the right-hand side. 
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figure? Py 


01. def makeTrack(): 


Tutorial 


# Function to make a new section of track 


02. global trackCount, trackLeft, trackRight, 


trackPosition, trackWidth 


03. trackLeft.append(Actor("barrier", pos = 


(trackPosition-trackWidth, @) ) ) 


04. trackRight.append(Actor("barrier", pos = 


(trackPosition+trackWidth, @) ) ) 
05. trackCount += 1 


>STEP-13 

Building the track 

We will need to set up a few more variables 

for the track. After your two lists, declare the 
following variables: trackCount = Gand then 
trackPosition = 250, then trackWidth = 120, 
and finally trackDirection = false. Then let’s 
make a new function called makeTrack(). Define 
this function after your update() function. See 
the figure2.py listing for the code to put inside 
makeTrack(). The function will add one track Actor 


on the left and one on the right, both using the image 


barrier.png. Each time we call this function, it will 
add a section of track at the top of the screen. 


>STEP-14 
On the move 


The next thing that we need to do is to move the 
sections of track down the screen towards the car. 


Let’s write a new function called updateTrack(). We 


will call this function in our update() function after 


Sigures.py 


01. def updateTrack(): 
blocks appear 


Figure 2 

The makeTrack() 
function. This 
creates two new 
Actors with the 
barrier image 

at the top of 

the screen 


Figure 3 The 
updateTrack() 
function. Notice 
the constant 
SPEED - we need 
to define this at the 
top of our program, 
perhaps starting 
with the value 4 


# Function to update where the track 


02. global trackCount, trackPosition, trackDirection, 
trackWidth 

03. jo = (2) 

04. while b < len(trackLeft): 

@5. trackLeft[b].y += SPEED 

06. trackRight[b].y += SPEED 

07. b += 1 

08. if trackLeft[len(trackLeft)-1].y > 32: 

09. if trackDirection == False: trackPosition += 16 

10. if trackDirection == True: trackPosition -- 16 

sb if randint(®, 4) == 1: trackDirection = not 
trackDirection 

127 if trackPosition > 700-trackWidth: 
trackDirection = True 

alee if trackPosition < trackWidth: trackDirection = 
False 

14. makeTrack() 
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STEP BY STEP 


CHANGING 


THE TRACK 
WIDTH 


The race 

car with barriers 
making up a track 
to stay within. The 
track pieces are 
created by random 
numbers so each 
play is different 


The 

draw() function 
and the update() 
function with 
conditions (if 
statements) 

to do different 
things depending 


gameStatus 


we do the keyboard checks. See the figure3.py 

listing for the code for our updateTrack() 

function. In this function we are using randint(). 
This is a function that we must load from an 

external module, so at the top of our code we write 
from random import randint. We use this function 
to make the track curve backwards and forwards. 


on the value of 
01 


iguret.py 


def (): # Pygame Zero draw function 

02. global gameStatus 

83. screen.fil1((128, 128, 128)) 

04. if gameStatus == 

05. car.draw() 

06. b = @ 

07. while b < len(trackLeft): 

08. trackLeft[b].draw() 

09. trackRight[b].draw() 

10. b += 1 

ls if gameStatus == 1: 

2: # Red Flag 

TE 

14. if gameStatus == 2: 

15: # Chequered Flag 

16. 

17. def (): # Pygame Zero update function 

18. global gameStatus , trackCount 

19: if gameStatus == 

20. if keyboard.left: car.x -= 2 

217 if keyboard.right: car.x += 2 

22T updateTrack() 

230 if trackCount > 200: gameStatus = 2 # Chequered 
flag state 
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Making more track 

Notice at the bottom of the updateTrack() function, 
there is a call to our makeTrack() function. This 
means that for each update when the track sections 
move down, a new track section is created at the top 
of the screen. We will need to start this process off, 
so we will put a call to makeTrack() at the bottom 
of our code. If we run our code at the moment, we 
should see a track snaking down towards the car. 
The only problem is that we can move the car over 
the track barriers and we want to keep the car inside 
them with some collision detection. 


A bit of a car crash 

We need to make sure that our car doesn’t touch the 
track Actors. As we are looking through the existing 
barrier Actors in our updateTrack() function, we 
may as well test for collisions at the same time. We 
can write if car.colliderect(trackLeft[b]) or 
car.colliderect(trackRight[b]): and then, 
indented on the next line, gameStatus = 1. We have 
not covered gameStatus yet — we are going to use this 
variable to show if the game is running, the car has 
crashed, or we have reached the end of the race. Define 
your gameStatus variable near the top of the program 
as gameStatus = @. You will also need to add it to the 
global variables in the updateTrack() function. 


Changing state 

In this game we will have three different states to the 
game stored in our variable gameStatus. The first or 
default state will be that the game is running and will 
be represented by the number 0. The next state will 
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Below Each of the barrier blocks is checked against the car to 
detect collisions. If the car hits a barrier, the red flag graphic 
is displayed 


be set if the car crashes, which will be the number 1. 
The third state will be if we have finished the race, 
which we’ll set as the number 2 in gameStatus. We 
will need to reorganise our draw() function and our 
update() function to respond to the gameStatus 
variable. See the figure4.py listing for how we do that. 


>STEP-18 

Finishing touches 

All we need to do now is to display something if 
gameStatus is set to 1 or 2. If gameStatus is 1 then 
it means that the car has crashed and we should 
display a red flag. We can do that with the code: 


E Welcome to Pyga x 


Table Of 
Contents 


aa tf) pygame Len 
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screen.blit('rflag', (318, 268)). To see if the 
car has reached the finish, we should count how many 
track sections have been created and then perhaps 
when we get to 200, set gameStatus to 2. We can do 
this in the update() function as in Figure 4. Then, 

in the draw() function, if the gameStatus is 2, then 
we can write screen.blit('cflag', (318, 268)). 
Have a look at the full code listing to see how this all 
fits together. 


The next thing that we need 
to do is to move the sections 
of track down the screen 


2 * E | e Python 3.5.3 Shell 


https://pygame-zero.readthedocs 10 " 


>STEP-19 

Did you win? 

If you didn’t get the program working first time, 
you are not alone - it’s quite rare to have everything 
exactly right first time. Check that you have written 
all the variables and functions correctly and that 
the capital letters are in the right places. Python 
also insists on having code properly formatted with 
indents. When it’s all in place, test your program 

as before and you should have a racing game witha 
chequered flag at the end! 


‘game Zer 
Py gi 


It is inten 


needing 9“ 


CHANGING 
THE SPEED 


If you want 
to make the 
track move 


faster or 


slower, try 
changing 
the value of 
SPEED at the 
start of the 
program. 


wy” i i The official Pygame Zero 
u i documentation can be 
found at magpi.cc 7 fBqznh 
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BE LE NSORELOVV 


16GB microSD 


=" ON RASPBERRY PI 


Discover how to install and use Google’s TensorFlow framework 
to learn Al techniques and add AI to your future projects 


oogle TensorFlow is a powerful open-source deployment, where you take a model and use it as 
software framework used to power AI projects part of a project. And that’s where the Raspberry 
around the globe. Pi fits in. 

TensorFlow is used for machine learning and the Although Raspberry Pi isn’t officially supported by 
creation of neural networks. These make it possible Google, there are example models included for the 
for computers to perform increasingly complex tasks, Raspberry Pi and it can be fun (if a bit hacky) to get 
such as image recognition and text analysis. TensorFlow up and running on a Pi. And there are lots 

When it comes to Al, most people think of powerful of interesting community projects around that put 
supercomputers crunching billions of numbers TensorFlow to good use. 
in giant databanks. But there are two parts to Using TensorFlow can give you a good 
machine learning. There is a train/test part, where understanding of how AI works, and how to put Al 
you use a lot of data to build a model. And there’s to practical use in your projects. 


$ Tl © aja se 


This modelis being used to fit blue 
and orange dots in an image. The 
more complex the layout of dots, the 
more layers the network needs (along 
with better activation functions). 


DE %& © Bicester: (YA neural Network Pia..| 
TensorFlow Playgrounds is a website 

that visualises deep neural networks. 

It's a good place to visit to understand 

some of the underlying concepts of 

artificial intelligence 


Playground - Chromium 


e in Your Brow TensorFlow Playgrounds helps you 
understand these concepts 


Ep a ate Actival Regularizat Re arization rate P lëm type 
Lil 
ò O 000,071 003 - Tarh - None = 6 - Classification 


DATA FEATURES + — 2 HIDDENLAYERS OUTPUT 
‘ n Test loss 0.025 EEN 
Seo ; i + - PS i pe Es 
4 neurons 2 neurons 
VË 
"B — 
E 
Ratio of training 
e 
—e 


REGENERATE 
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2STEP-01 

Install TensorFlow with pip 

TensorFlow can be incredibly easy to installona 
Raspberry Pi, or something of a nightmare. It depends 
on the current build and which version of Raspbian 
OS you are running. Installation is often troublesome, 
but we’ve had recent success with building it directly 
using pip. Open a Terminal window and enter: 


sudo apt-get update && sudo apt-get upgrade 
sudo apt-get install python3-pip python3-dev 
pip3 install tensorflow 


>STEP-02 

Build from wheel 

If pip doesn’t work, you can try to build TensorFlow 
using the wheel file. In a Terminal, enter: 


sudo pip3 install --upgrade https:// 
storage. googleapis.com/tensorflow/1linux/cpu/ 
tensorflon-1.8.0-cp34-cp34m-linux x86 64.uhl 


Alternatively, you can use a nightly wheel built for 
Raspberry Pi, which is available from magpi.cc/xKLBzu. 
Download the wheel file and run it, like this: 


sudo pip3 install --upgrade tensorflow- 
1.9.6rc0-cp34-none-linux armv71.uhl 


Take a look at TensorFlow’s Install Sources page 
(magpi.cc/yIpbCX) or Common Installation Problems 
page (magpi.cc/EHocYB). 


>STEP-03 

Build from source 

If pip fails, you could always build TensorFlow from 
source; Sam Abrahams has written detailed instructions 
on doing so (magpi.cc/oCYtme). You will need a spare 
USB stick (1GB or higher) to extend the amount of swap 
space on your Raspberry Pi and be sure to follow the 
instructions carefully. It takes around six hours to build, 
but we have gone through the steps and they do work. 


>STEP-04 
Hello TensorFlow 
Hopefully, you 
So let’s start it up. Open Python 3 (IDLE) using Menu 
> Programming > Python 3 (IDLE). Choose File > New 
File and enter the hello_tensorflow.py code. 

Save the code file as hello_tensorflow.py and 
Choose Run > Run Module. You will get a warning 
because TensorFlow is compiled for Python 3.4 and 
we’re running Python 3.5. Don’t worry, the code 
works. The Python shell will display: 


"dello TensorFlow' 


raspberrypi.org/magpi 


now have TensorFlow up and running. 


hello _tensorflow.py 


import tensorflow as tf 

hello = tf.constant('Hello, TensorFlow! ') 
sess = tf.Session() 
print(sess.run(hello)) 


A Python 2713 Shell | pë, hello.tensorfiov py 


Ele Ede Format Bun Qptions window telp 
By ss tf 


>PYTHON 


DOWNLOAD: 


magpi.cc/HuGfDm 


Simple variables, like strings, are stored inside objects known as 


“Tensors'. These are only accessed via a session, which makes 
even a simple Hello World program more complex than usual 


>STEP-05 

Pi examples 

Google has a bunch of models developed for 
Raspberry Pi that you can test out. Start by cloning 
the TensorFlow repository: 


git clone https://github.com/tensorflow/ 
tensorflow. git 


Follow the instructions from on the page at 
magpi.cc/BrsbKi to build the example models. 

Now head to the part of the TensorFlow repository 
at magpi.cc/sGOzbr to find Google example models 
and instructions. 

The default example is a picture of Grace Hopper. 
Run it and you will see that it identifies a ‘military 
uniform’, ‘suit’, and ‘academic gown’ (and then other 
items in order of decreasing probability). From here 
you can see how this model could be used to identify 
objects in your own images, and use that in your own 
code. There is also a link to an example that uses the 
Pi Camera Module directly: magpi.cc/xGurWt. 


>STEP-06 

Community TensorFlow 

Now you have everything you need to start using 
TensorFlow. It’s a big subject and there’s far more 
to it than we could outline in this tutorial (or even 
this entire magazine). Learn by doing and follow 
some TensorFlow projects. Start with Sarthak Jain’s 
‘How to easily detect objects with deep learning on 
Raspberry Pi’ (magpi.cc/DFFAYt) or Alasdair Allan’s 
‘Magic mirror with TensorFlow’ (magpi.cc/YGtrOB). 


SIGN UP FOR 
THIS UDEMY 


COURSE 


If you want 

to learn 
TensorFlow in 
depth, or are 
finding the 
‘TensorFlow 
without a 
PhD’ course 
limiting, then 
sign up for 

a course. 
There are lots 
of different 
courses out 
there, and 
we've tried a 
lot of them. 
Jose Portilla 
is the Head of 
Data Science 
at Pierian 
Data and his 


Udemy course 


‘Complete 
Guide to 
TensorFlow’ 
(magpi.cc 7 
VJUKKJ)is 
the best 
TensorFlow 
course we 
have found. 
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ODING GAMES 
ON THE RASPBERRY PI 


IN C/C++ Bitty 


Code::Blocks 
sudo apt-get 
codeblocks 


stb_image.h 


KEEP 
ASSETS TIDY 


At the moment 
we're not really 
doing that other 
than keeping 
them in a folder. 
We'll discuss 
this soon. 


60 | MagPi July 2018 


Animate a character and start making a platform game 


e’ve gone as far as we can with the basic 

bat-and-ball game, so it’s time to introduce 

another stalwart of the 2D era and create a 
simple platform game - this time with a character we 
can control, who can walk, jump, and climb, to avoid 
some fairly unintelligent baddies. 


Animation 101 

What is animation” It might seem obvious, but why 
is it that cartoons and movies allow us to see multiple 
individual frames as smooth(ish) motion? 

All screen-based visuals are based on a simple concept 
called image retention, where we trick the brain into 
thinking that a sequence of rapidly changing frames 
(each not massively different from the previous one) 
appear to be in motion. As long as we can keep the frame 
rate up, these individual still frames will seem to move 
smoothly; our brain will fill in the missing frames. 

The rate of animation can be quite variable, but 
most people start to see ‘jerkiness’ if an animation 
is less than 15-20 fps (frames per second). Individual 
perception limits vary quite a bit from person to 
person. Cartoons and movies mostly rely on 24 fps, 
but there are a few people who see that as jerky. We 
will generally set a 20 or 30 fps rate on animation, 
even if the game is updating at 6o fps. 

Like traditional cartoons, all computer graphics, 
even 3D, rely on there being enough frames to give the 
impression of the motion you want to represent over a 
sensible time for that motion to occur. You can make a 
character walk with just two images changing every 30 
frames, but it looks better with four changing every 15, 
and better still with eight every seven or eight frames. 


ERRA 


Frame 0 - 3 of a right facing walk 
Frame 0 can also be a stand 


T 


Frame 0-3 of a Climb frame 


Figure 1 Simple individual frames 


The more images for the sequence you have, the 
smoother the animation, but you are eating up your 
memory by storing so many individual sprite images. 
So a balance must be found. 

Figure 1 shows two simple four-frame animations. 
Since we’re only going to use a few frames for walking, 
we could cheat and reuse them for walking, standing, 
falling, and jumping, though at the moment we do 
need left- and right-facing. Each of these different 
actions we will call a ‘state’, but each state needs to 
keep track of what sequence of animation it is doing 
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and how the control system will change depending on 


the state. For example, we can’t really jump or climb if 


we are currently falling. 

Separating the actions of our character into states 
means we can focus on the control that is relevant to 
that state and, where needed, signal a change in state 
- from walking to jumping, for example. 

By defining each action as a state, we are making 
our first attempts at a state machine, where different 
code is called depending on the setting of that stage. 
That code can also change the state, allowing us to 
switch back and forward between states depending on 
whatever conditions we want to test. A good example 
might be when falling: we are only going to test to see 
if we should stop falling, and if we find ground under 
our feet, we switch into a standing frame, or perhaps 
even a duck-and-roll landing sequence state. Ora 
splatting into a bloody mess state if we are feeling a 
bit nasty and our hero fell a long way. Sadly, we don’t 
really have enough graphics to let our imagination 
loose just yet. 

Simple state management can be done with 
sequences of if-then-else conditions, but C/C++ gives 
us a much neater concept called a switch, which calls 
different code based on different ‘case’ statements. 
Refer to Figure 2. 

Generally speaking, being able to keep the code for 
a specific state lets us focus on only dealing with the 
conditions that relate to that state. For example, when 
walking, we do not need to worry about jumping code, 
but we do need to test if we should be falling down. 
Our code becomes more about managing the state we 
are in at given points than trying to work out which of 
the five or six different abilities we give our character. 
This allows for expansion of ability and isolation of 
the code to provide those abilities. 


Using maps 
Our bat-and-ball game touched on the concept of 
maps, since our screen was basically made up of an 
array which we interacted with. That array was a map, 
where each cell related to a specific tile on screen. 
But platform games take the concept of a map toa 
new level. Consider how many levels you can have in 
a game like Super Mario Bros; all these levels use the 
same quite limited and basic tile set, yet clearly there 
are thousands of cells making up each map. A cell in 
a map, however, can be represented by a single byte 
(though more typically a 32-bit integer) and allow 
us to have arrays of any size to represent quite huge 
numbers of levels. 

What’s more, those levels can be larger than the 
screen size, and by simply moving a screen view 
area — under the control of the principal character in 
our game ~- we can create scrolling. The view screen 
area moves as we want it to, but generally under the 
control of our principal character who drags the view 
along. We’ll tackle that next time. 
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typedef enum { // we define the names of our states like this 
STANDING = 0, 
WALKING, 
JUMPING, 
CLIMBING, 
FALLING, 
DROWNING 


} StateVaues; 


void Bob: :BobsLogic() 
1 


switch (CurrentState) 77 the Switch asks what is our current state represented as an enumerated value or int 


case STANDING: 
//Do code for a standing character 
break; // this ends the code 

case WALKING: 


Tutorial 


break; // notice we must end each section with break...if we don't it falls through 


case JUMPING: 

//Do code for a jumping character 

break; // this ends the code 
case CLIMBING: 

Do code for a climbing character 

break; // this ends the code 
case FALLING : 

//00 code for a falling character 

break; // this ends the code 
case DROWNING : 

//Do code for a drowingcharacter 
break; // this ends the code 
default : // 

//do default code, which usually means we have forgotton something 
break; 
} // close the switch 


Figure 2 How a switch keeps states separated 


We’ll start with a single screen map for now, 
which is called Map2 in the code. As you can see 
in Figure 3 over the page, this is a fairly simple 
platform game layout, but drawn the exact same 
way as our bat/ball map, which does create some 
issues we will discuss soon. 

Remember that our characters do not interact 
directly with the screen: our screen only gives us 
a visual interpretation of what happens during 
the map interaction. So as long as we keep our 
code focused on the characters’ interaction with 
the map, we can move our screen around any way 
we want. 


Our main character 

Our new character is called Bob. The Bob class inherits 
from our simple objects and, like our previous balls, 
has some information on graphics and position which 
lets us draw him. Take a moment to review the code 
and the comments that explain what it’s doing. 

Bob’s class is a little like our old Bat class: Bob is 
the only one who cares about the keys, so he’s going 
to read the keys, move around, jump, and test if he’s 
standing on something; if not, he’s going to obey the 
laws of gravity and fall, though we won’t splat him if 
he falls too far. 

Gravity in game worlds acts very similarly to gravity 
in the real world: it’s always there and pulling you 
down, but as long as there’s ground beneath us we 
don’t fall through. So we need to test if there’s ground 
under our feet during our normal, non-gravity- 
defying states. 

Gravity is usually represented as a speed in platform 
games: 0 when on the ground and whatever amount we 
find works best when not on the ground. To jump, we 
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this is a special case in case we have not found code for a particular state value 


MagPiHelloTriangle. 
cpp 
SimpleObj.h/cpp 
Game.h/cpp 


OGL.h/cpp 
BalLh/cpp 
NevvBall.h7 cpp 
Paddle.h/cpp 
Input.h/cpp 


DOWNLOAD: 
magpi.cc7 YUdxXy 


KEEP CODE 
READABLE 


Comments 


are great, but 
readable, self- 
descriptive 
code is better. 
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Tutorial 


Figure 3 
A nice new map! 


STATE 
MANAGEMENT 
MAKES LIFE 
EASY 


Keep your 
states vvell 
defined and 
separate, 

and focuson 
making each 
state work 
before starting 
another. 


LEARN 


MORE 
ABOUT C 


Brian has a 
whole book 
on the subject 
of making 
games C and 
C++, called The 
Fundamentals 
of C/C++ Game 
Programming: 
Using 
Target-based 
Development 
on SBCs. Grab 
it here: 
magpi.cc/ 
nUKjEt 


ose: 
MAMENTALS OF 

THe FUNDAMENTALS OF 
GAME PROGRA SS 


Brian Beoken am 
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WALKTHROUGH 


Lessons PE Soace Gene cop L 


move then sË because the referenc iz in t 


simply give ourselves an upward speed and when gravity 
is in effect, we deduct it from the character’s current 
speed, creating a reduction in his upward motion until it 
eventually goes negative, causing him to fall. 

By adding a Speed value to the co-ordinates of our 
character, we can get much smoother - and, later, 
timed - movement in our characters. We can also 
use this speed concept for left and right motion, 
using friction to reduce it. The source code for Bob’s 
movement shows this principle for both vertical and 
horizontal movement. 


What am | standing on? 

Testing the tile relies on us knowing the reference 
point of Bob. Usually that’s the centre of the sprite, 

so a simple offset of half his height will get our testing 
point to be at his feet. In fact, we should add an extra 
one pixel, since we want to test what’s just below 

his feet. Also, since our sprite is wider than a tile, we 
should really test a few points to make sure that if any 
part of the main graphics that make up the sprite are 
on a ground tile, we prevent the fall. 

Now we have gravity, jumping is a simple case of 
giving him an upward speed that initially overcomes 
the force of gravity, but which is constantly reduced 
by gravity. With the result that what goes up, must 
come down, until it lands on a ground tile. 

Jumping and climbing both start by pressing the Up 
key, so clearly a decision needs to be made when Up 
is pressed to determine if we climb or jump, and that 
will depend on our test of whether we are on a ladder 


How many ground tiles do we have, and how can we test? 


Ground =1 
Ladder =2 


in Binary bit 0 = Ground 
in Binary bit 1 = Ladder 


Tile 1 has attribute 00000000000000000000000000000001 
Tile 2,3,4,7,8,9,10,11, 15 are the same 


Tile 14 has attribute 00000000000000000000000000000011 
Because its both ground and ladder! 


Figure 4 Encoding tile attributes into bit fields 


DF Tdi eja 


or not. In order to climb a ladder, vve must knovy vyhich 
tile represents the ladder, in this case tile number 14. 

Now, that is fine — we can test for our offset in the 
array to see ifit has hit that tile number and if the 
correct up/down keys are pressed when were are over 
or above a ladder, we can change state to climb - but 
what if we have more than one ladder type? (We don’t. 
But... what if we did?) 


That’s a lot of ifs 


Our map is fairly simple, but we’re already considering 
testing for two or three different concepts of what 
makes a ground tile we can stand on. At the moment, 
tile numbers 1, 2, 3, 4, 7, 8, 9, 10, and 11 appear to be 
types of ground. Our ladder, 14, is also in some ways a 
ground tile - so is a brick tile, so is a girder tile, so is 

a grass tile, etc. So we need to consider if sequentially 
testing tiles with a whole bunch of if statements is a 
wise move. 

Well no, of course it’s not, for all sorts of reasons. 

It is hard to manage when we add new tiles and it also 
makes the code test for the last tile in the list slower 
than the code test for the first. 

A better idea is to consider that each tile has certain 
attributes, which we can encode into bit fields. Bits 
are the basic binary (on/off) components that make 
up all our data values, and it’s possible to set and test 
individual bits (Figure 4). We don’t need to be able to 
count in binary to use it, we just need to know that the 
bits are usable and very useful. In an int we have 32 
bits, so we can store 32 on/off attributes. 

Our simple game only really needs two concepts at 
the moment - Ground and Ladder - but we could later 
consider Metal and Brick as an attribute and trigger 
different types of walking sound effect. 

Because we can use bit fields to define an attribute, 
we can in theory have 32 different attributes assigned 
to every tile, and that means that tiles which serve the 
same purpose but have different tile numbers can be 
treated the same in code. 

The main difference from our viewpoint is that 
instead of testing for a tile number, we use that tile 
number to look up the attributes for that tile and test 
the attribute. 


Next time 
This is all so far so good, but clearly there’s a massive 
issue: the speed of our game has fallen to unplayable 
levels! Do we know why? The source code has a #define 
called FastUpdate - try setting it to true and see what 
a difference it makes. 

Next lesson we’ll examine how to do scrolling, add 
some baddies, and also make more improvements 
to our updating to explain and further improve the 
performance of the tile draws. Sadly, there wasn’t 
space this month to discuss text/font systems, so we’ll 
try to fit that in next time to make score display and 
menu/instruction screens much simpler. 
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ISSUE #08 


Tutorial 


JODY CARTER 


Jody is a primary school teacher and 
computing leader for a MAT. He is 
grateful for the Raspberry Pi camera as it 
SË saves him from having to stand outside 
in the rain to take bad pictures of vvildlife. 
twitter.com/codeyjody 


| 


BUILD A WILDLIFE 
CAMERA TRAP WITH 


> Pi Camera 
Module 
magpi.cc/ 
camera 


2 Pi NolR Camera 
Module (optional) 
magpi.cc/ 
ircamera 


2 ZeroCam 
NightVision 
(optional) 
magpi.cc/ 
qaXcLK 


> Waterproof 
container (like 
a jam jar) 


2 Blu Tack, Sugru, 
elastic bands, 
carabiners 


> ZeroView 
(optional) 
magpi.cc/ 
2e89hWt 


Uncover the goings-on in your garden, pond, or school playground 
when no one’s looking with this easy-to-use Raspberry Pi camera trap 


ver wondered what lurks at the bottom of 

your garden at night, or which furry friends 

are visiting the school playground once all the 
children have gone home? 

Using a Raspberry Pi and camera, along with 
Google’s Vision API, is a cheap but effective way to 
capture some excellent close-ups of foxes, birds, 
mice, squirrels and badgers, and to tweet the results. 

Using Google’s Vision API makes it really easy to get 
AI to classify our own images. We’ll install and set up 
some motion detection, link to our Vision API, and then 


Get a decent power 
bank that will last for 
at least seven or eight 
hours overnight 


low and ensure it’s 
tight up against any 
glass or plastic 
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tweet the picture if there’s a bird in it. It's assumed you 
are using a new Raspbian installation on your Raspberry 
Pi and you have your Pi camera set up (whichever model 
you’re using). You will also need a Twitter account anda 
Google account to set up the APIs. 


Motion detection with Pi-timolo 

There are many different motion-detection libraries 
available, but Pi-timolo was chosen as it is easy to edit 
the Python source code. To install, open a Terminal 
window and enter: 


Use sealable containers 
and jars and make sure 
they're watertight 


ee 
ikorg7 magpi 
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isting 2 pen 2 


61 search for userMotionCodeHere. NAME: 

@2. # There will be 2 results, Se : 
motion_detection_ 

03. # edit the second so you are passing code.py 

filename to the function 

04. userMotionCodeHere(filename) DOWNLOAD: 
magpi.cc/qoRuSW 

05. 

06. # make sure you include filename as a 


parameter in the function 
@7. def userMotionCodeHere( filename): 


08. # we need to create an instance of the Google Vision API 
09. client - storage.Client() 
10. # instantiates a client 
Ae Unledsh your mien spring ware! ili. client = vision. ImageAnnotatorClient() 
128 
cd ~ 13% # loads the image into memory 
wget https://raw.github.com/pageauc/pi- 14. with io.open(filename, 'rb') as image file: 
timolo/master/source/pi-timolo-install.sh 15. content = image file.read() 
chmod +x pi-timolo-install.sh ace A 
./pi-timolo-install.sh I7 image = types. Image(content=content) 
18. 
Once installed, test it by typing incd ~/pi-timolo 12- pe ia eal ole ey ae tie 
gs 8 20. response = client.label_detection(image=image) 
and then ./pi-timolo. py to run the Python script. ; : 
. : 21, pass the response into a variable 
At this point, you should be alerted to any errors such 27. label. = response label annatations 
as the camera not being installed correctly, otherwise 23. 
the script will run and you should see debug info in 24. we have our labels, now create a string to add to the text 
the Terminal window. Check the pictures by waving 25. for debugging - let’s see what Google thinks is in the image 
your hand in front of the camera, then looking in 26. print('Labels: ') 
Pi-timolo > Media Recent > Motion. You may need to 27. add labels to our tweet text 
change the image size and orientation of the camera, 28. tweetText = “Labels: " 
in the Terminal window, enter nano config.py 29. animalInPic = False 
and edit these variables: imageWidth, imageHeight, 30. for label in labels: 
and imageRotation. 31. print(label.description) 
While we’re here, if you get a lot of false positives, 32. tweetText = tweetText + " " + label.description 
try changing the motionTrackMinArea and 33. # edit this line to change the animal you want to detect 
motionTrackTrigLen variables and experiment with 34. if “bird” in tweetText: animalInPic = true 
the values by increasing to reduce sensitivity. See 35. 
the Pi-timolo GitHub repo (magpi.cc/PFqFSJ) for 36. # set up Tweepy 
more details. Bie # consumer keys and access tokens, used for authorisation 
There’s also going to be some editing of the 38. consumer key = “XXX? 
pi-timolo.py file, so don’t close the Terminal window. 39. consumer secret = “XXX” 
Code needs to be added to import some Python 40. Deeg hc) ae 
libraries (Listing 1), and also added to the function 41. access token secret = ‘XXX’ 
userMotionCodeHere() to check with the Vision aa ; 3 ; 
43. # authorisation process, using the keys and tokens 
44. auth = tueepy.OAuthHandler(consumer key, consumer secret) 
6 5 45. auth.set access token(access token, access token secret) 
fisting 1 as. 
47. creation of the actual interface, using authentication 
AS. api = tweepy.API(auth) 
01. # add this in at the very top, under 49. 
print('Loading ....') along with the other 50. # send the tweet with photo and message 
| libraries imported 51. photo_path = filename 
02. import io Spl # only send tweet if it contains a desired animal 
93. import tweepy 53, if animalInPic: 
04. from google.cloud import vision 54. api.update uith media(photo path, status=tweetText) 
05. from google.cloud.vision import types 5oe 
06. from google.cloud import storage 56. return 
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vision cameras 


API before tweeting (Listing 2). We can do this now in 
preparation of setting up our Google and Twitter API. 
You should still be in the Pi-timolo folder, so type nano 
pi-timolo. py and add the imports at the top of the 
file. Next, press CTRL+W to use the search option to 
find the UserMotionCodeHere( ) function and where 


We will be using Google Label 
Detection, which returns a list 
it associates with the image 
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it’s called from. Add the new code into the function 
(line 240), before the return line. Also locate where 
the function is being called from (line 1798), to pass the 
image file name and path. Press CTRL+X then Y and 
RETURN to save. Next, we’ll set up the APIs. 


Animal detection and tweeting 

We will be using Google Label Detection, which 
returns a list it associates with the image. First off, 
you will need to install the Google Cloud Vision 
libraries on your Raspberry Pi, so type pip install 
--upgrade google-cloud-vision into your 
Terminal window. Once finished, run pip install 
google-cloud-storage. 

Now you need authorisation, by going to 
magpi.cc/xVLSVa to set up an account. Click on the 
Manage Resources link and create a new project (you 
may need to log in or create a Google account). Go 
to the API Dashboard and search for and enable the 


Vision PI. Then go to API & Services > Credentials, 
click on Create Credentials > Service Account Key 

> New Service Account from the drop-down. Don’t 
worry about choosing a Role. Click Create and you’ 
be prompted to download a JSON file. You need this 
as it contains your service account key to allow you to 
make calls to the API locally. Rename and move the 
JSON file into your Pi-timolo folder and make a note 
of the file path. Next, go back to pi-timolo.py and 
add the line: os.environ["GOOGLE_APPLICATION_ 
CREDENTIALS"] = "path_to_your_.json_ 
credential file” below import os to reference the 
credentials in your JSON file. 

Finally, set up a Twitter account if you haven’t 
already and install Tweepy by entering sudo pip 
install tweepy into a Terminal window. Once set 
up, visit apps.twitter.com and create a new app, 
then click on Keys and Access Tokens. Edit the code 
in userMotionCodeHere() with your own consumer 
and access info, labelled as ‘XXX’ in the code listing. 
Finally, place your camera in front of your bird feeder 
and run ./pi-timolo. py. Any pictures taken of a 
bird should now be tweeted! If you want to identify 
a different animal, change the line if "bird" in 
tweetText: animalInPic = true. 

Please note that although the API works well, it 
can’t always discern exactly what’s in the picture, 
especially if partially in view. It also won’t distinguish 
between types of bird, but you should have more 
success with mammals. You can test the API out with 
some of your pictures at magpi.cc/EBzDam and visit 
twitter.com/pibirdbrain to see example tweets. Good 
luck and happy tweeting! 
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CoderDojo 


Can Í start a 
CoderDojo club 
in my local area? 


CoderDojo is a global network of free, volunteer-led, project-based 
programming clubs for children aged 7-17. Dojos are championed by 
individuals all around the world who are passionate about giving young 

people the opportunity to learn to code. 


incredibly 
rewarding experience 


“I started a Dojo to give my kids a place to meet other children also 
interested in programming and making games. | get to see them 
making new friends, learning from one other, and they loved it. 
Realising how | had created such a wonderful place for children has 
ignited a spark in me.” 

- Maroes, CoderDojo NL 


Start your own club. Join us at CoderDojo.com 


The CoderDojo Foundation is Irish Registered Charity (524255) CHY20812 oe R berry Pi 
and is part of the Raspberry Pi Foundation, UK registered charity 1129409 amo aspberry 


FREQUENTLY 
ASKED QUESTIONS 


YOUR QUESTIONS ANSWERED 


LEARNING 


RESOURCES 
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Official projects site 

Part of the Raspberry Pi Foundation’s mission 

is to make sure there are plenty of free learning 
resources for students and educators to make use 

of, and you can find a huge range of guides on 
projects.raspberrypi.org. Many have been translated 
into a variety of languages as well! 


Raspberry Pi Forum 

The forum is the number one place to go if you’re 
having trouble with a project. There’s a wealth of 
information there which you can find with the search 
bar, and an active community that will try to help you 
with your problem: raspberrypi.org/forums. 


Raspberry Pi Press 

The MagpPi is published by the Raspberry Pi Press 
(store.rpipress.cc), and everything made there 
is available for free as a PDF. While it’s not all 
specifically aimed towards education like our 
Beginner’s Book, there are a lot of guides and 
inspirational projects that will help you on your 
Raspberry Pi journey. 


Picademy 

The Raspberry Pi Foundation provides free teacher 
training via the Picademy scheme, currently in the 
UK and USA. At these two-day events, teachers and 
educators can learn everything they need to know 
about using the Raspberry Pi and using it to teach kids 
about computing and digital making. Find out more 
here: magpi.cc/2Bakf96. 


NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 


find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


After-school clubs 

Code Club (codeclub.org.uk) and CoderDojo 
(coderdojo.com) are networks of weekend and 
after-school clubs that are part of the Raspberry 
Pi Foundation. They offer free resources for kids 
to learn about computing, which are used around 
the world. 


Hello World 

The magazine for 
educators is available 
as a free PDF and you 
can also get a print 
subscription of it for 
free. It includes lesson 
plans and features 
aimed towards 
teachers and other 
educators who are 
working in computer 
science fields: 
helloworld.cc. 


Adafruit 

These US-based makers specialise in components 
and add-ons for the Raspberry Pi, as well as awesome 
tutorials on how to make cool things. This includes 
handheld retro consoles, face-recognition locks, and 
so much more! Check them out here: adafruit.com. 


Hackster.io 

You can always find people sharing great Raspberry Pi 
tutorials on hackster.io (that’s the web address) from 
all around the world! Not all of them may be to your 
taste, but the team also do regular highlights of the 
best projects which you can use for inspiration. 


elementi14 

Farnell’s community side is a great way to see people’s 
building process, thanks to various competitions 
revolving around different challenges. You can even 
enter a challenge yourself to try to win something. 
Check it out here: magpi.cc/GrmbXe. 
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WHAT ARE THE DIMENSIONS 

OF THE RASPBERRY PI? 

The Raspberry Pi Model B versions measure 
85.60 x 56 x 21mm (roughly 3.37 « 2.21 x 0.83 
inches), with a little overlap for the microSD 
card and connectors which project over the 
edges. They weigh 45g. The Pi Zero and Pi 
Zero W measure 65 x 30 x 5.4mm (roughly 
2.56 x 1.18 x 0.20 inches) and weigh gg. For 
the mechanical outline, please see the 
documentation: magpi.cc/xhPBSq. 


WHAT HARDWARE DOCUMENTATION 
IS AVAILABLE? 

All available documentation is in 

our documentation repository: 
magpi.cc/ujsAel. 


WHAT SOC ARE YOU USING? 
All models of Raspberry Pi use Broadcom 
SoCs, containing a VideoCore IV GPU but 
with various ARM CPU cores. 


The original Raspberry Pi used a 
Broadcom BCM2835. This contains a 
single-core ARM1176JZFS with floating 
point, running at 7OOMHz, and a VideoCore 
IV GPU. The GPU is capable of Blu- 
ray-quality playback, using H.264 at 
40MBps. It has a fast 3D core, accessed 
using the supplied OpenGL ES 2.0 and 
OpenVG libraries. 

The Pi 2 Model B originally used the 
Broadcom BCM2836. This contains a quad- 
core ARM Cortex-A7 processor with floating 
point and NEON, running at gooMHz, and 
the same VideoCore IV GPU that is in the 
earlier models of Raspberry Pi. 

The Pi 3 Model B uses the Broadcom 
BCM2837, containing a quad-core ARM 
Cortex-A53 running at 1.2GHz. Its GPU 
capabilities are equivalent to the Pi 2. 
Newer Pi 2 boards now use the same SoC 
as the Pi 3, but downclocked to match the 
speed of the original Pi 2 SoC. 


Having trouble with The MagPi on the App Store or Google Play? 


Here are your most common questions answered. 


How do | find The MagPi on Google Play or the App Store? 


Allyou have to do is go to the search bar and type ‘The MagPi' 


or 'Raspberry Pi' to find us. 


MAGIC: THE 
GATHERING 
CARD COUNTER 


I've subscribed to the digital edition and I can't sign in 


to restore my purchases. Please help! 


WILDUE C AMERA 


Since your The MagPi purchases are linked to your Google or Apple 


The new Pi 3 Model B+ uses the 
Broadcom BCM2837Bo, containing a quad- 
core ARM Cortex-A53 running at 1.4 GHz. 


WHAT IS A SOC? 

Asystem-on-a-chip (SoC) is a method of 
placing all necessary electronics for running 
a computer on a single chip. Instead of 
having an individual chip for the CPU, GPU, 
USB controller, RAM, etc., everything is 
compressed down into one tidy package. 


WHY DID YOU SELECT THE SOC? 
Cost and performance. 


HOW DOES IT BOOT? 

As standard, all the files necessary for 
booting are installed in a FAT32 partition 

of the microSD card. The latest firmware/ 
software, however, allows booting to be set 
up without a microSD card, for example from 
a USB stick or other mass storage device. 


RUN ANDROID 
ON RASPBERRY PI 


accounts, there's no need to sign in at all. If you'd like to re-download 
your purchases on your current device, or make your purchases 
available on other devices, all you need to do is hit Menu on the home 
screen, then Restore Purchases on the sidebar. 


GET IT ON 


Dy Google Play 


How can I search the digital magazine for keywords? 

Finding direct references is really easy with The MagPi app - 

all you have to do is tap the screen to get the app's GUI to show, 
and then press the small magnifying glass icon in the top-right 8 Available on the 


corner of the screen. Now, just type in your search term to find the € App Sto re 
relevant results. 
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feature BUILD A VV 


2 Raspberry Pi vvith vvireless connectivity 
(or a vvireless dongle) 


> BME280 pressure, temperature, and 
humidity sensor magpi.cc 7 LFGBDK 


> DS18B20 digital thermal probe 
(with 1m lead) 


> 2 x 4.7kQ resistors 


> Some 5mm-pitch PCB mount screw 
terminal blocks 


2 Abreadboard, some jumper wires 


> Anemometer, wind vane, and rain gauge 
magpi.cc/txkqdr 


> 2 x RJ11 breakout boards (optional) 


> MCP3008 analogue-to-digital converter 
integrated circuit magpi.cc7 BIHLKm 


> Weatherproof enclosures; 
recommended products are the IP55 
Thermoplastic 7 Entry Junction Box 
Enclosure (magpi.cc/myRZHW) and 
IP55 Thermoplastic 10 Entry Junction 
Box Enclosure (magpi.cc/uYvzUZ) 


\ 
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BUILD YOUR WEATHER STATION TO MEASURE 


TEMPERATURE, HUMIDITY, AND ATMOSPHERIC 
PRESSURE, WIND AND RAINFALL. COME RAIN OR 
SHINE YOU LL BE ABLE TO SEE WHAT'S COMING 


n 2016, Raspberry Pi sent out 
nearly 1000 Oracle Raspberry Pi 
Weather Stations to schools from 
around the world who had applied to 
receive these kits. 

The Weather Station kit enables a 
Raspberry Pi to collect weather data using 
a variety of sensors. These kits have been 
very popular. If you’re one of the many 
people who has been wanting to get hold 
of one, this guide will take you through 
the process of building your own. 

This is an advanced project, both in 
terms of electronics and programming. 
You can find the full project, with 
even more details, on the Raspberry Pi 
website: magpi.cc/SYWwma. 


et stuck while making this 
act, you can find help on the 
bee Pi forums. There is a 
cated board for the Weather Station. 


De 
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BUILD A VVEATHER STATION Bi2UJiIN2 


SOFTWARE DOWNLOAD 


You’ll need the Oracle Raspberry Pi Weather Station 
software. You don’t need to install it, but you’ll use some 
of the Python programs. Clone the GitHub repository by 
opening a Terminal window and typing: 


You can find more information on this library at the 
Python Package Index (magpi.cc/dhSyei). 


And install the MariaDB database server software: 


git clone https://github.com/ 


ë 4 i sudo apt-get install -y mariadb-server mariadb- 
RaspberryPiFoundation/weather-station 


client libmariadbclient-dev 


Now install the BME280 Python library: 
sudo pip3 install mysqlclient 


sudo pip3 install RPi.bme280 


EPEE TET EA KR 
ve at My 
ih DTA t 
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The anemometer has 
three arms with scoops 
on the end that catch the 
wind and cause the arms 
to spin. This measures 

the wind Speed 


i tects 
e wind vane de 
T direction the wind 
is coming from 


A 3D-printable mount 
is used to secure the 
Raspberry Pi inside 
the larger box 


i The smaller box contai . 
nta 
a BME280 integrated ji 
environmental sensor. 


This provides data on 
the humidity, pressure 
and temperature ; 
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The BME280 sensor is a digital sensor 
that can measure temperature, 
humidity, and atmospheric pressure. 

It is available in a number of breakout 
boards from popular manufacturers such 
as Adafruit and SparkFun. This guide 


Figure 1 How to 
wire up the sensors 
to the Raspberry Pi 


A bucket gathers 
is full, 


Rainfall 
ES 


Wind Sensors 
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assumes you have the Adafruit package 
(magpi.cc/IFGBDk), but the instructions 
should be applicable to most versions. 
One thing to check is that the PC 
address is correct: for the Adafruit 
models it is 0x77 (as shown in the 
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TURN YOUR RASPBERRY 
PLINTO A HEAT AND 
HUMIDITY MACHINE 

USING A BME280 SENSOR 


bme280_sensor.py code), but other 
versions can have different addresses 
(0x76 is acommon alternative, as shown 
in bme280_sensor_2.py). 


(AVIdSIC) ISC 
PLLLIJTILITI 


Pi GPIO | BME280 


17 (3V3) Vin 

6 (GND) GND 

3 (SDA) | SDA (SDI) 
5 (SCL) : SCL (SCK) 


Wires to DS18B20 
SEES 


fritzing 
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In Raspbian, select Menu > Programming > 
Python 3 (IDLE). Create a new Python file, 

save it as bme280_sensor.py in the /home/pi/ 
weather-station directory and add the code 
from bme_280_sensor.py to it. 


STEP 2. 


While the code is running, exhale onto the 
BME280 sensor. You should see the humidity 
value (and possibly the temperature) increase. 
Press CTRL+C to exit the program. 


STEP 3 


Replace the loop witha 

function called that returns 

the humidity, pressure, and temperature 
readings, in that order. Update your code using 
bme_280_sensor_2.py as a guide. 


STEPA 


The BME280 will report the air temperature, 
but this can be warmer than the ground, 
particularly if it’s frosty. A DS18B20 thermal 
probe (magpi.cc/JILuTd) stuck into the soil is 
a useful supplemental measurement. 


STEP 5 


Normally the DS18B20 comes with three bare 
wires, so the easiest way to test it is to use 

PCB mount screw terminal blocks that can be 
plugged into breadboards. Add your DS18B20 to 
your circuit as shovyn in Figure 1. 


STEP 6 


Open the file /boot/config. txt: 


Edit it by adding the line below at 
the bottom: 
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The Adafruit BME280 IC y (e) 
or SPI Temperature Humidity gp X 


Pressure Sensor AARS 


Then open /etc/modules: 


Add the lines below at the bottom 
of the file: 


Reboot the Raspberry Pi. 


Open the file /home/pi/weather-station/ 
ds18b20_therm.py in IDLE and run it (see 
‘Software download’ box on page 71 to use Audi 
Git to clone this file). You should see the 

temperature printed outin the Python 

Shell window. 


bme280_sensor.py 


01. import bme280 

02. import smbus2 

03. from time import sleep 

04. 

905. port = 1 

06. address = 0x77 # Adafruit BME28@ address. Other BME28@s 
may be different 

07. bus = smbus2. 

08. 

09. i1s(bus address) 

10. 

11. while True: 

IA bme28@_data = bme280. (bus, address) 

13. humidity bme280 data. humidity 

14. pressure = bme28@ data.pressure 

15. ambient temperature = bme280 data.temperature 

16. rint(humidity, pressure, ambient temperature) 

17. (1) 


(port) 


bme280_sensor_2.py 


01. import bme280 

02. import smbus2 

03. from time import sleep 

04. 

05. port = 1 

06. address = 0x76 

07. bus = smbus2. 

08. 

09. is(bus, address) 

10. 

Lila read all(): 

IA bme28@_data = bme.s: (bus, address) 

13. return bme28@ data.humidity, bme28@_data.pressure, 
bme280 data.temperature 


(port) 


July 2018 Më 73 


So far, all the sensors you” ve 

used have been passive electronic 
sensors that just sit there and make 
measurements of their surroundings. 
Hovvever, to measure things like 
rainfall and wind speed/direction, 


July 2018 


you’ll need to use active mechanical 
devices that physically interact with 
the environment. 

The original Oracle Weather Station kit 
employed popular wind and rain sensors 
(magpi.cc/mkxjNE) that are used in 


YOU'VE DEALT WITH 
HEAT, NOW IT’S TIME 
TO TACKLE ANOTHER 
ELEMENT: AIR 


many consumer weather stations. These 
are the recommended sensors to use, as 
they are robust and reliable. Their data 
sheet (magpi.cc/ibPeBX) gives more 
information about the sensors’ size 

and construction. 
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Anemometers normally have two wires. 
Connect one to a GND pin, the other to 
GPIO 05. If using the RJ11 connectors, 
the anemometer uses the middle two 
wires of the cable: normally pins 3 and 4 
on RJ11 breakout boards. 


STEP 2 


Open IDLE, create a new Python file, 
and save it as wind_speed.py in the 
/home/pi/weather-station directory. 
Add the code from the wind_speed.py 
listing. Save and run your code. Test 

it by manually turning the arms of 

the anemometer. 


The anemometer produces two signals 
per spin, so you can count the number 
of full rotations of the sensor by 
halving the number of detected inputs. 


This can then be used to calculate the 
wind speed: 


speed = distance / time 


To calculate speed, you need to know 
the distance travelled in a certain 
amount of time. Measuring time is 
fairly straightforward, and you can 
count the number of signals over 

the course of a fixed time period, 

for example 5 seconds. The distance 
travelled by one of the cups will be equal 
to the number of rotations multiplied 
by the distance around the edge of the 
circle (circumference): 


speed = (rotations x circumference) 
/ time 


The circumference can be calculated as 
long as you know either the radius of 
the circle. You can discover the radius 
made by the anemometer by measuring 
the distance from the centre to the edge 
of one of the cups. Once you know the 
radius, you can find the circumference 
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E py 


from gpiozero import Button 


= import time 
03. import math 
04. 
05. mind count = 
many half-rotations 
06. radius_cm = 
07. mind interval = 
08. 


© # Counts how 


9.0 # Radius of your anemometer 
# How often (secs) to report speed 


09. # Every half-rotation, add 1 to count 


10. spin(): 

11. global wind_count 
12, wind_count = 
13. # print("“spin" 
14. 

15. # Calculate the wind speed 


wind_count + 1 
+ str(wind_count)) 


16. calculate_speed(time_sec): 


17. global wind_count 
18. circumference_cm = 
19. rotations = 
20. 


(2 * math.pi) * radius_cm 
wind_count / 2.0 


21. # Calculate distance travelled by a cup in cm 


22. dist_cm = 
23. 

24. speed = 
25. 

26. return speed 
27. 

28. mind speed sensor = 


30. 


circumference cm * rotations 


dist cm / time sec 


n(5) 


29. mind speed sensor.uvhen pressed = 


spin 


31. # Loop to measure wind speed and report at 5-second intervals 


32. while True: 

33. wind_count = 
34. time. 

35) 


with the formula 2 x at x radius. Don’t 
forget that a whole rotation generates 
two signals, so you’! need to halve the 
number of signals detected: 


speed = ( (signals/2) x (2 x x x radius) ) 
/ time 


The radius for the recommended 
anemometers used by the original 
Oracle Weather Station is 9.0cm, and 
that is the figure which is used in the 
code example. Don’t forget to change 
this value if your anemometer has 
different dimensions! 

To implement this formula in Python, 
you can use the h library. For 
example, if you measured 17 signals 
from your anemometer in 5 seconds, 
your wind speed could be calculated like 
the code in vvind speed. py. 


Ga interval) 


(uind, interval), “cm/h") 


If you look inside the recommended 
wind vane, you’ll see eight reed switches 
arranged like the spokes of a wheel. 
These can be used to measure the wind 
direction. In order to do so, you’ll need 
to be able to measure the resistance 
produced by the sensor and convert that 
into an angle value. There are several 
steps in this process, and you need an 
analogue-to- digital converter (ADC). 
A popular and versatile ADC is the 
MCP3008 (magpi.cc/BIHIKm) 
Measuring the wind direction is a 
bonus project and you can read how to 
set up the rotating magnets and ADC 
here: magpi.cc/nZNLga. 
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BUILD A VVEATHER STATION 


YOU CAN'T STOP 
IT RAINING, 

-> BUTYOUCAN 

- MEASURE IT IN 

A BUCKET 


Most rain gauges measure precipitation Station kit is actually a simple collected and channelled into the 

in millimetres in height collected on mechanical device included with the bucket. Once enough rainwater has 

one square metre during a certain Argent Systems Wind / Rain Sensor been collected, the bucket will tip over, 

time period. (magpi.cc/bWcYpvV). the water will drain out from the base, 
The recommended rain gauge sensor This rain gauge is basically a self- and the opposite bucket will come up 

supplied with the Raspberry Pi Weather emptying tipping bucket. Rain is into position. 


i 
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The product data sheet (magpi.cc/ltofJB) 
tells us that 0.2794 mm of rain will tip 
the bucket. You can multiply this by the 
number of tips to calculate the amount of 
rainfall. If you’re using a different type 
of rain gauge, then you should consult 
the relevant data sheet or determine the 
volume of water required experimentally. 


(STEP 2) 


The top of the back wall does come off if 
you want to see inside; just pull on the 
flat end gently and it should release. 
Inside there’s a small circuit board 
that you can remove to examine. In the 
middle of it you will see the reed switch. 
Replace the circuit board and back wall lid 
before continuing. 

When one of the buckets tips, the 
magnet passes the reed switch, causing 
it to close momentarily. So, just like with 
the anemometer, if you connect the rain 
gauge to a GPIO pin on the Raspberry Pi, 
you can treat it like a button and count the 
number of ‘presses’ to calculate rainfall. 


STEP 3) 


To test the rain gauge, you’ll need to 
either remove the RJ11 connector and 
strip the wires, or make use of an RJ11 
breakout board. 

The Oracle Weather Station rain 
gauge is connected to GPIO06, 
so for consistency, use the same 
pin for your device. (See the 
main Figure 1 circuit diagram on 
page 72.) 


Using the code you wrote for the 
anemometer as a starting point, 
write a program called rainfall.py 
(saved in the /home/pi/weather- 
station directory) to detect when 


J 
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the rain gauge bucket has tipped. It should 
print out a running count of how many 
bucket tips have occurred. 

Now that you can count bucket tips, 
you need to convert this into a height of 
water that equals the amount of rain that 
has fallen. 

Finally, we use a function named 
reset rainfall to reset the count of 
bucket tips so that it starts at o again. 
You will need this function for your fully 
operational weather station. 


| rainfall.py 


01. from gpiozero import Button 
02. 

03. rain_sensor 
04. BUCKET_SIZE = 
05. count = 9 
06. 

07. bucket_tipped(): 


(6) 
0.2794 


08. global count 

09. count = count + 1 

10. (count * BUCKET SIZE) 

11. 

127 reset rainfall(): 

is global count 

14. count = 8 

15. 

16. rain_sensor.when_pressed = 
bucket_tipped 


STORING 
IN A DATABASE 


One of the best ways to store 
your weather data is in a 
database. Databases can store 
very large numbers of records 
efficiently and make it easier 
to sort, search, and analyse 
your data. 

There are many different 
pieces of database software, 
and MariaDB is a good, versatile 
general-purpose product. You 
should have already installed 
it - if not, head back to the 
‘Software download’ section on 
page 71 and install it. 

Now follow the instructions at 

to learn how to 
set up and run your database. 
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NOW THAT YOU HAVE ALL YOUR COMPONENTS WORKING, IT $ TIME TO 
TURN THEM INTO A DEVIGE THAT GAN LIVE IN THE GREAT OUTDOORS 


So that your vveather station can upload typically the easiest way to do this, but connectivity on your Raspberry Pi at 

data to somewhere you can view and you can use the Ethernet connection if magpi.cc/fTclJO, and some special hints 
analyse it, it will need some form of that works better for your location. for getting wireless access working with a 
joena connection. Using WiFi is There’s a guide about setting up wireless weather station are at magpi.cc/klShuT. 
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feature 


STEP 
KEEP IT DRY 


Find two waterproof enclosures: one 
larger one for the Pi and the breadboard 
or HAT, and another smaller one for the 
BME280 sensor. The larger box should 
have a couple of holes for the RJ11 cables 
connecting the wind and rain sensors, 
and for some long wires to the BME280. 
If using the recommended enclosures 
(see p70), you can use this 3D-printable 
mount (magpi.cc/aadkGv) to secure the 
Raspberry Pi inside the larger box, and 
this one (magpi.cc/rGSAQc) to hold the 
BME280 sensor in the smaller one. 


STEP 2 
SEALIT UP 


Use short self-tapping screws to secure 
the mounts into the holes and/or 
grooves at the back of the larger box. 

In order to get representative readings 
for ambient temperature and humidity, 
air needs to circulate around the BME280 


It is not possible to provide specific 
instructions for mounting your 
station, as the exact method will 
depend on your particular location 
and environment. However, here are 
some tips for a couple of aspects 

of the process that should help you 
get started: 


- Installing your Weather 
Station outside: wind sensors 
(magpi.ce/ Pxbabi). 


- Installing your Weather Station 
outside: connecting to WiFi 
(magpi.cc /jujoYP). 


You may not be able to find an ideal 
location. Perhaps trees block the 
wind, or the rain gauge is partially 
sheltered by an overhang. Don't 
worry, just install your weather 
station anyway. 


sensor. Remove both hole covers from 
one side of the smaller box. You can then 
pass the wires for the sensor up through 
one hole. Make sure you mount this box 
outside with the holes facing downwards 
so that rain cannot enter this way. 

Use waterproof nylon cable glands to 
prevent moisture entering the enclosure 
through the holes used for the cables. 


Ter 3 
PLUG THE HOLES 


The larger recommended enclosure has 
holes on all four sides that are sealed 
with rubber plugs. Use three of these 
holes along the bottom of the box to 
provide an escape route for your cables. 
Use an M16 cable gland in each of the 
two outer holes and pass the cable for 
the rain gauge through one and the cable 
for the wind sensors through the other. 

Use the larger M20 gland for the 
centre hole and feed the power cable, 
DS18B20 probe, and the wires for the 
BME280 sensor through. 


STEPA 
CRACKIN’, GROMMET 


The hole in the M20 is quite large, so you 
should pad the cables to ensure a tight 
fit. A 3D-printable grommet is available 
at magpi.cc/PrfCnV. Use two grommets 
rotated at 180 degrees to each other so 
that there is no gap all the way through. 


STEP 5 
MOUNTED OUTSIDE 


You could mount your station on a wall, 
rooftop, fence, or even on a plumbing 
pipe stuck in the ground. The larger box 
can be installed inside, to help keep it dry 
and allow easier connection to power and 
networking. However, the various cables 
for the external sensors (rain gauge, wind 
vane, anemometer, and BME280) will 
then all need to be routed inside, so this 
may involve a bigger hole in an external 
wall. Mounting everything outside means 
you only have to supply power to the 
weather station (assuming you are using 
wireless connectivity for data transfer). 


7 aad 
MAKE 4 WEATHER 
STATION HAT 
You should now have a working 
weather station prototype ona 
breadboard. For a more robust, 
long-term installation, or if you 
don’t have room for a breadboard 
in your enclosure, you can construct 
a weather station HAT (hardware 
attached on top) for your Pi. This 
will involve some soldering - if 
you’ve never soldered before, 
Raspberry Pi has a great resource 
plus video tutorial to get you started: 
magpi.cc/VKGfig. 
Note that to really be able to call it 
a HAT, your board should include a 
programmed EEPROM. The Adafruit 
Perma-Proto HAT kit does come as 
a variant with an EEPROM, so this 
is definitely something you could 
do, although we aren’t covering 
the procedure in this guide. A 
good place to start is this GitHub 
repository (magpi.cc/ILpFCS), or 
this article (magpi.cc/iAEnXI). 
If you want to turn the 
components into a HAT, then 
follow these instructions: 
magpi.cc/INdatp. 


FINAL APVICE 
DONT FORGET 


- The anemometer and wind 
vane need to be in the wind. 


- The smaller BME280 box 
needs to breathe - try to avoid 
situating it in direct sunlight. 


- The weather station needs to 
be connected to power, and to 
a network (wirelessly or via an 

Ethernet cable). 
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Maker 
says 
YetiBorg 

v2 is a great 

kit to get 

Started with 

Raspberry Pi 


robotics! 
PiBorg 


YETI 


CAMJAM 
EDUKIT 3 

A beginner's kit 
that's slightly 
more suitable 
for true novices. 
The price is 
very attractive 
as well. 


£18 / $24 
magpi.cc/28KDW9S 
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YETIBORG V2 


ORG V2 


Rob Zwetsloot looks at the new YetiBorg robot kit. 
Does its diminutive size make it better for beginners? 


ast month in The MagPi 
we took a look at the 
DiddyBorg v2 robot kit 
from PiBorg. This relatively large 
kit from the PiBorg team is a 
fantastic, robust robot kit that is 
fantastic for veteran Raspberry Pi 
robot builders wanting something 
a bit more advanced to play with. 
We don’t think it’s the best kit 
to choose for beginners, though, 
which is where the YetiBorg v2 
comes in. 

In comparison to the DiddyBorg, 
it’s pretty small, although it’s 
definitely not the smallest Pi 
robot kit out there. Unlike other 
beginner-friendly robot kits, it 
includes all the high-quality parts 
and chassis you’d expect from a 
PiBorg kit. This quality comes at 
a price, though, and at £160 it’s 
quite a bit more than your classic 
robot starter kit. 


Construction is pretty simplified, 
with a fantastic step-by-step guide 
that takes you through the entire 
build process. There’s no soldering 
involved as it comes complete 
with pre-soldered motors and 
a Raspberry Pi Zero with a pre- 
soldered GPIO header. We received 
our YetiBorg fully constructed, in 
fact, but we estimate you’d be able 
to build it in under an hour, and 
the software won’t take you long to 
sort out either. 

This kit comes with a ZeroBorg, 

a quad motor controller designed 
with the Pi Zero in mind. While 

it may be smaller than the 
ThunderBorg controller used in the 
DiddyBorg, the ThunderBorg is only 
able to control two (or two sets of) 
motors at a time. This means the 
YetiBorg is truly a four-wheel-drive 
robot. Like the ThunderBorg, you 
can stack ZeroBorgs to add more 


motor controls if you wish, and 
while it is designed around the Pi 
Zero form factor, there’s no reason 
you can’t use it with a full-sized 
Raspberry Pi if you so wish. 


High performance 
The YetiBorg comes with example 
scripts to get you started, including 
a remote control script using a 
game controller, a web interface 
that lets you see through a 
mounted Pi camera (not included), 
automated scripts, and more. 
You can use these to learn how 
the robot works and then cobble 
together your own scripts so the 
robot will do as you wish. 

While the ZeroBorg code is 
still quite complex as per the 
ThunderBorg code, it’s a bit easier 
to understand overall. It’s no 
GPIO Zero but it’s still readable, 
although we suggest that you 
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already have a basic grasp of 

Python before tackling it. 
Still, it’s quite fun to have the 

YetiBorg trundling around using 

a game controller. It’s not super- 

quick either, so you won’t have any 

problems with it running off your 


that it’s for people getting into 
Raspberry Pi robotics; however, 
we’re not quite convinced that it 
is. At least, we wouldn’t say it’s 
well suited to kids or teens looking 
to learn about the Pi, computing, 
and robotics with a Raspberry Pi 


With its ZeroBorg quad motor 
controller, the YetiBorg is truly 


a four-wheel-drive robot 


table or smashing into walls, and the 
extra functions with the example 
remote-control script — such as a 
button to reduce your speed - give 
you an idea of how you can program 
and control the YetiBorg. 


Friendly for beginners? 
One of the selling points of the 
YetiBorg over the DiddyBorg is 
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robot kit. The barrier for entry with 
the code is just a little too high 
compared to other robot kits we’ve 
used in the past. 

However, we do think it’s quite 
well suited for adults confident 
in their computing skills who 
want to try their hand at robotics 
with a Raspberry Pi. The simple 
setup allows anyone to get it up 


YETIBORG V2 $2172 


£160 / $224 


N 


and working pretty quickly, while 
the example scripts help you to 
become familiar with the ZeroBorg 
libraries. Whereas kids’ robot 
kits tend to be a bit cheap and 
disposable, the YetiBorg works well 
as a basic platform to then grow 
from, rather than throwing it away 
when you get your new robot kit. 
As for younger makers, while it 
may not be a good first kit, it could 
perhaps make an excellent second 
kit to really learn about the ways 
of Raspberry Pi robotics. 


{ast word 


More of an adult beginner's kit than a young 
maker's kit, this robot is still a great product from 


the PiBorg team for those wanting something 
smaller than the DiddyBorg. 
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PI-HOLE 


Maker 
says 


Ads can 
be blocked 
on any 
device and 
even in apps 
Pi Supply 
Block annoying internet adverts using this pre-built Pi kit 
illed as a black hole for IP for the Pi-hole. You can then web interface: changing the 
internet adverts, Pi-hole run the device as a headless server, DNS listening behaviour to ‘all 
is free and open-source with a wired or wireless connection interfaces’ instead of “etho” did 
software for the Raspberry Pi. to the router. the trick (since our Pi-hole wasn’t 
While you could create your own wired to the router). The web 
Pi-hole server, Pi Supply’s kit Enable ad blocking interface is also very handy for 
comes pre-built and is almost a The main way to enable network- seeing how many web queries have 
plug-and-play device. Inside the wide ad blocking is to set your been blocked, viewing a query log, 
sleek, branded black case — also router’s DNS address to that ofthe and black/whitelisting any that 
PI-HOLE available separately for 615 — is Pi-hole. However, some routers should be blocked/unblocked. 
FOSS a Pi3 and 16GB microSD card (including ours) don’t permit 
Alternatively, to with Pi-hole pre-installed (in users to change the DNS setting. 
build your own Raspbian). You also get a power One alternative is to disable the Jast word 
Pi-hole server 
with an existing supply, plus HDMI and Ethernet router’s DHCP server and enable : : i 
Raspberry Pi, cables. An online setup guide is one on the Pi-hole. This seemed While setup wasn't quite as 
eee ae provided at pisupp.ly/pihole. alittle daunting, so we opted to aes ane hoped - ae 
open-source Initial setup involves wiring the instead set the DNS address to ue TO SeT a NEW PaSSwon 
Pi-hole software. Pi-hole device to your router and Pi-hole’s IP manually on each to log n tothe wap interface 
Si ani ; E : - the Pi-hole device worked 
==. Oe connecting ittoa TV. While BIEtiole device — a more flexible option. really well on the normally 
is pre-installed, you need to set it We soon encountered a problem, : E 
: ad-heavy sites we tried. Yay, 
Avett , Up for your network. A Terminal however: no webpages were 


no more autoplay video ads! 


Free command brings up a setup wizard, loading! After a lot of Googling and 
which prompts you to input your head scratching, we eventually 


router’s IP address and set a static found a setting in the Pi-hole’s 
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Raspberry Pi 3 B+ finds a new 
home 


Versatile enclosure for Raspberry Pi 3 Bt 


The new UCS-RPI Universal Case System is compatible with the recently launched 
Raspberry Pi model 3 B+. It has pre-milled side walls for easy access to the I/O and 


power inputs and is available in black or grey and two sizes. Complete with glue dot 
location posts to secure the single board computer to the case. 


For additional information call 0845 881 2222 or visit 
phoenixcontact.co.uk/UCS-RPI 
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INSPIRING INNOVATIONS 


RASPBERRY PI 
BESTSELLERS 


ClojureScript, along with JavaScript's 
functional features, enables more robust and 
responsive web apps in a ‘serverless’ world. 


BEGINNING 
FUNCTIONAL 
JAVASCRIPT 


Author: Anto Aravinth 
Publisher: Apress 


ISBN: 978-1484226551 
magpi.cc/RxKNXL 


If you're an OO programmer 
struggling with the concepts of 
functional programming, Aravinth's 
explanations should help make 
things clear. A second edition with 
better editing would be welcomed, 
but the author's knowledge and 
enthusiasm will carry you past 
grammatical errors. 


QUICK CLOJURE 


Authors: Quick Clojure 
Publisher: Mark McDonnell 


ISBN: 978-1484229514 
magpi.cc/fEJhMU 


If you'd rather get the basics 
of Clojure under your belt 
before tackling ClojureScript 
(or a Clojure web server-based 
project), this concise guide is 
a truly enjoyable introduction 
to all the bits of the language 
that you'll really need. 


REACTIVE WITH 
CLOJURESCRIPT 
RECIPES 


Author: Nicolas Modrzyk 
Publisher: Apress 


ISBN: 978-1484230084 
magpi.cc2 xXjmjs 


ClojureScript is a Clojure that 
compiles to JavaScript and, as 
Modrzyk shows here, works 

well for functional reactive 
programming (FRP). The recipe 
book approach works well 

- allowing for beginner and 
relatively advanced topics to rub 
along well together. 
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HEAD FIRST 
LEARN TO CODE 


Head First 
Learn to Code 


A Bral Friend Guide 


Author: Eric Freeman 
Publisher: O'Reilly 
Price: £39.99 

ISBN: 978-1491958865 
magpi.cc/lTnVbT 


There are many books on 
learning to code with Python, and 
several of them are actually fun — 
and we’ve really enjoyed reviewing 
them — but the latest book in 
O’Reilly’s excellent Head First series 
stands out. The first chapter is 
about ‘Thinking Computationally’ , 
and combines an introduction to 
what programming languages are 
and how they work, with an easy 
and practical introduction to some 
Python code. Nicely done, and very 
beginner-friendly. 

Variables are introduced with a 
dog age calculator program, then 
Booleans and control structures 
are explained with Rock, Paper, 


STATISTICS WITH R: 
A BEGINNER'S GUIDE 


STATISTICS WITHR 


Author: Robert Stinerock AGRONI ove 
Publisher: Sage 

Price: £100 

ISBN: 978-1473924895 
magpi.cc/jKQuZz 


A student textbook 
which introduces 
statistics and analytical skills 
through the R language, reflecting 
the change in teaching even dry and 
conceptual topics like statistics. 
Indeed, knowledge of R is close to 
essential for those looking to learn 
statistical methods and start a 
career in finance, pharmaceuticals, 
or even the civil service. This 

book is differentiated from many 

R introductions in being solidly 
grounded in teaching everything a 
first-year student of statistics needs 
to know. 

Tabular, graphical, and numerical 
methods in statistics lead on 

to problems in probability that 
depend upon them, and a look 


ROBERT STINEROCE 


s 


d 


Scissors. After lists, functions, 
and a look at the bubble sort 
algorithm, there’s a substantial 
project which puts everything 
together, and involves slicing 
strings and lists to measure the 
readability of texts - playing to 
Python’s strengths. 

Six more chapters build on 
readers’ achievements and give 
the skills and techniques needed 

for programming, from making 
reusable code and working with 
the file system, via recursion, to 
interacting with web APIs and 
building a graphical user interface. 
From using Turtle graphics to 
represent location data from 

the International Space Station, 

to canine humour in the OOP 
chapter, Freeman keeps this fun 
and engaging. Great for adults 
who want to learn to code, but also 
recommended for teen learners. 


Score 


at everything from sample space 
to Bayes’ theorem. Discrete and 
continuous probability functions 

lead on to binomial probability 
distribution — concepts again 
reinforced with the exercises. More 
advanced topics, such as hypothesis 
testing and multiple regression, 

are introduced after the appropriate 

foundation knowledge. A very 

comprehensive introduction. 

The formal textbook approach 
carries the penalty not just of a 
certain dryness that might make 
difficult reading for those who’ve 
become used to programming 
books leavened with humour, but 
also an eye-watering textbook 
price, although it’s also available 
as a paperback for £34.99. For 
those not constrained by budget, 
this is a good guide indeed - clear, 
well structured, and featuring well 
chosen examples and exercises. 


Score 
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DEEP LEARNING 
VVITH PYTHON 


Author: François Chollet 
Publisher: Manning 
Price: £39.99 

ISBN: 978-1617294433 
magpi.cc7 cvqSKy 


François Chollet is 
the originator of 
the Keras deep learning library, and 
wrote this book to address the need 
for a course to “simultaneously 
cover fundamentals of deep 
learning, Keras usage patterns, 
and deep learning best practices.” 
This user-friendly, open-source, 
high-level neural networks API was 
developed “with a focus on enabling 
fast experimentation,” enabling 
quick learning and testing of ideas. 
The Keras project has excellent 
documentation, but Chollet’s book 
provides a great introduction to 
machine learning, neural networks, 
and best practices for deep learning. 


20 EASY 
RASPBERRY PI 
PROJECTS § 


Authors: Rui Santos 

& Sara Santos 
Publisher: No Starch 
Price: £21.99 
ISBN: 978-1593278434 
magpi.cc7 MEAAvk 


For beginners fascinated by the 
possibilities of fun, simple projects 
on the Raspberry Pi - or educators 
without an electronics background, 
looking to learn and get teaching 
examples - this colourful and 
well-laid-out introduction could 
be ideal. The 20 practical project 
tutorials include details of cost, 
time needed, parts list, basics 
electronic knowledge (practical, 
not theoretical), and what you can 
do to take it further. 

Projects start with LED basics, 
then add mini screens (Pong, 
weather forecaster), sensors, 
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RASPBE 
Ph 


Example-led explanations are clear, 
and the total beginner to the field 
is quickly learning quite advanced 
topics without fear — with 
examples to take to real- 
world problems. Appendices 
cover not just installation, 
but running examples in 
Jupyter notebooks with 
cloud-backed GPUs. 
It’s less maths-heavy than 
many deep learning books, 
but for most that will bea 
selling point. Certainly, Chollet’s 
explanations and examples will 
give you most of the knowledge you 
need, with a lot less mental strain, 
and readers prepared to tackle 
some of the more mathematical 
books may benefit first from some 
practical experience found here. 
Broadly recommended for anyone 
looking to dive into the exciting field 
of machine learning. 


Score 


camera (burglar detector with photo 
capture), web apps, and toys and 
games. One of the highlights in 

the latter section is the 
Digital Drum Set. The 
photography is extremely 
clear, helping beginners to 
follow the circuits easily. 
tare Siena Along the way, Python 
code is given, and 
explained line-by-line 
where appropriate. There’s 
enough Python intro text 
to explain what you’re doing, but 
it’s not a full coding intro — just 
the right amount of information to 
aid those who want to get on with 
making things, and learn as they 
go. There’s also a Scratch game, 
controlled by two push-buttons. 
It’s interesting to see Scratch 
introduced towards the end of 

a book, and liberating to not be 
bound by the idea that graphical 
comes before text-based. 


Score 


BOOKS 


ESSENTIAL READING: 
SUMMER READING 
ESSENTIALS 


Summer means downtime - perhaps a 
beach holiday - and time to read and think. 


The Code Book 


Author: Simon Singh 
Publisher: Fourth Estate 
Price: £10.99 

ISBN: 978-1857028898 
magpi.cc/jtCAbf 


An eminently readable and 
understandable guide to codes and 
code-breaking, from ancient ciphers 
to PGP and quantum cryptography. 


The Hardware Startup 
Authors: Brady Forrest, Renee DiResta — 

& Ryan Vinyard THE 
Publisher: O'Reilly HARDWARE 
Price: £27.99 STARTUP 


ISBN: 978-1449371036 
magpi.cc/IZZQNQ 


Practical guide to knowing your 
market, funding, developing your 
product, and manufacturing: is your 
project a viable business? 


Lauren Ipsum 
Author: Carlos Bueno 
Publisher: No Starch 
Price: £13.50 

ISBN: 978-1593275747 
magpi.cc/Eowlip 


Great to see the kids reading anything, 
but this (and The CS Detective, also ee LOS BUENO @ 
from No Starch) will entertain and a 
educate simultaneously. 


Clean Architecture 


Author: Robert C. Martin 
Publisher: Prentice Hall 
Price: £27.99 

ISBN: 978-0134494166 
magpi.cc/ShtTnu 


Clean Architecture 


Insightful collection of software 
architecture advice from Uncle Bob - 
principles and techniques which will 
help any project. 


If Hemingway Wrote JavaScript 


Author: Angus Croll 
Publisher: No Starch k= 
Price: £15.99 HEMINGWAY 
ISBN: 978-1593275853 WROTE 
magpi.cc/xNKMLo JAVASCRIPT 


Acoding book you could read on the 
beach - humour and style insights 
with code by everyone from Calvino to 
Chaucer [allegedly!]. 
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RASPBERRY PI 


~ THE CHALLENGE 
OF TRANSLATION 


KAT LEADBETTER TELLS US 
HOW YOU CAN HELP CODE CLUB 
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FEATURE 


t Code Club and CoderDojo, we’ re always 

working towards our long-term mission: to 

start Code Clubs and Dojos in every community 
on Earth. As part of that, we’re committed to helping 
as many children as possible access our resources in 
their native languages. The challenge? There are more 
than 6000 languages spoken around the world today... 

When Code Club and CoderDojo began to expand 
outside the UK and Ireland, amazing members from 
across the community realised the need for translated 
materials and stepped forward to offer their help. 
Thanks to these volunteers, we have since translated 
projects into more than 20 languages, from Croatian to 
Chinese and Portuguese to Polish. 

“Last year, I translated Code Club projects into 
Chinese,” says volunteer Jarod Yv. “Now kids can read 
the project articles by themselves and follow the tasks 
to create their own programs step-by-step. They get 
more coding practice and improve their programming 
skills rapidly.” 

With our increasing number of translations, 
volunteers are also motivated to make the most of the 
projects they have worked on. Code Club volunteer 
Marcus is planning to start using Welsh translations in 
his club, Layla will use Farsi translated projects in Iran, 
while Venancio is keen on making Raspberry Pi better 
known in Colombia. 

Our volunteer translators come from all backgrounds, 
professions, and walks of life. No technical or coding 


AND CODERDOJO TRANSLATE 
THEIR EREE RESOURCES 


knowledge is needed! Translating is also a great way to 
get involved if you have language skills but don’t have 
the time to volunteer at a regular Code Club or Dojo. 
Translators give a couple of hours of their time each 
week, but it’s up to you when you decide to work on 
translations. Depending on your English skills, we can 
also match you up with tasks that best suit your ability 
and confidence level. 


How does translating work? 

To make our translation process as easy and efficient 
as possible, we use the latest technology. Machine 
translation uses artificial intelligence to translate 
phrases automatically, without the help of humans, 
and translation memory saves all previous translations 
and suggests them to translators who are working on 
something similar. 

Translators use an online platform called Crowdin, 
which combines these technologies in one place and 
provides an easy and intuitive editor for translators 
to work in. Projects are first translated with machine 
translation, after which a volunteer checks translation 
and makes any necessary changes. The project then 
goes through two other steps (review and test) to help 
us make sure that the quality of the final translation 
is excellent. At each step of the process volunteers are 
supported by our amazing Translations Manager, Nina, 
and there is also a community of other translators 
ready to give you a hand. 
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MAJA MANOJLOVIC 


Language: Croatian 
“Së Number of projects translated or reviewed: 23 


Pma student at the University things, engage in interactions 

of Rijeka in Croatia. My college with other volunteers — the list 
professor suggested I help is endless! The fact that you are 
translate Code Club projects helping children all over the world 
as a part of my M.A. thesis - to learn coding is also a reward 
since lam majoring in English in itself! 


and Informatics, it was a great 
opportunity to connect both my 
majors and gain more experience 
in translating! 


What advice would you give to 
others thinking about translating? 
I would encourage anyone who 
has any interest in translating or 
coding to get involved, because 

it is a great way to engage in 
something fun and new. You 

will learn so much, explore new 


KARL SCHUH 


et Language: German 
Number of projects translated or reviewed: 40 


How did you start translating? What advice would you 

I think through The MagPi. Late give to others thinking 

in 2016 I had a go at translating about translating? 

the Code Club project ‘Happy I really like to translate. It is 
Birthday’ and last year I got an quite easy to do if you are a bit 
email from Code Club and decided of a techie and it gives you a 

to get involved again. My main good feeling to bring children 
motivation was to go over the an interesting and creative way 
basics of using a Raspberry Pi and to spend their time. My advice: 
learn about some simple exercises just start doing it! It is a nice 


which could be used for teaching community and all of us are 
adults, if the need for it came up willing to help newbies. 
at my job. 


What have you found most 
rewarding about translating? 
Translating pushes me to polish 
up my knowledge of the English 
language. I understand uncommon 
phrases and words I didn’t 

know before. 
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COR GROOT 


Language: Dutch 


wep Number of projects translated or reviewed: 52 


How did you start translating? 
Since my retirement I have 
volunteered at a hackerspace 
where we introduce students from 
primary schools to everything from 
soldering, to coding with Scratch 
and robotics. For the computer- 
related workplaces, I developed 
all the lesson packages and found 
how difficult coding in English 
can be for Dutch youth. I started 
looking at how I could contribute to 
changing that. 

Because I play a lot with 
Raspberry Pi and Arduino, I 
soon came into contact with the 


SILVIA CAPONIO 


Number of projects translated or reviewed: 45 


( Language: Italian 


Pm a 23-year-old language 
enthusiast from Bari, southern 
Italy. At the moment Pm studying 
for my Master” s at the University 
of Sheffield, specialising in — you 
guessed it — Translation Studies. 


How did you start translating? 
When my professor said Raspberry 
Pi was looking for volunteer 
translators, I immediately signed 
up. Their projects introduce 

young people to computing and 
digital making, and develop their 
problem-solving skills in a fun 
way — something I strongly support. 
Through the projects I found out 
about Code Club and CoderDojo, 
and I found myself immersed in 
an amazing, positive community 
of people who work hard and 
collaborate and communicate with 
each other every day. 
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Raspberry Pi Foundation, as well as 
Code Club and CoderDojo. That led 
me to join the translation group. At 
the moment I have translated and 
reviewed various projects for the 
Raspberry Pi, Scratch, HIML & CSS, 
and Python. 


What advice would you give to 
others thinking about translating? 
Translating is easy with the help 

of various translation sites on the 
internet, and we regularly chat 
within our translation group about 
the best translation for a sentence 
or subject. If you want to help us to 


introduce young people to coding, 
then join us, choose a project that 
suits you, and start translating! 
You’re helping children, you will 
learn a lot yourself, and most 
importantly: it’s fun! 


What advice would you give to 
others thinking about translating? 
Translating and localising technical 
texts for a younger audience is 

an incredibly fun, challenging, 
compelling task. The translation 
process seems complicated 

at first, but the guidelines are 
straightforward and you can always 
ask for help! My advice for any 
prospective volunteer who wants 

to join this brilliant community 

is — have fun! Don’t be afraid to 

ask for advice: everyone is there to 
help you! 
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CROWDFUND 


| The best crowdfunding hits this 


I HI S m month for you to check out... 


NIBBLER CASE 170 


This one is not specifically for a Raspberry Pi, but 
is a great way to organise your breadboard circuits 


for Pi projects. The case is made of laser-cut acrylic 


or wood depending on your choice, has magnetic 


catches, and comes with a little breadboard that fits 


perfectly inside. 


Here are some other great 


things we saw this month 


DNIAT ae ei) 
AGA a ie 


Apparently this is Reddit 
user CHRISFRED's first Pi 
project - they've installed 
LEDs into the top of a cap 
to show during graduation. 
It cycles between 
different messages and 
images - hopefully it’s 
controllable so that when 
it's thrown into the air, 

the perfect picture can 
be taken. Especially as it 
will probably break as it 
crashes to the floor. 


If you've not heard of them before, the Let's Robot 
team put up video streams with their robots which the 
viewers can control. Now you can steer a Pi-powered 
robot that cuts the lawn. This is frankly amazing - the 
grass will never have been so thoroughly cut! 


raspberrypi.org/magpi 


STACKABLE 
8-RELAY CARD 


A spin-off of the Mega-IO expansion card 
(kck.st/2eLc4no) that removes a lot of the 
functionality in favour of just including the relays. 
They can be stacked easily, which allows for greater 
control of many more devices than what you can do 
with just the GPIO pins on their own. 


We got an email from 
Isaac, 14, of Awesome 
Industry to tell us 

about his great new Pi 
Wiimote-loT project on 
GitHub. You can use it to 
control Phillips Hue lights 
and Sonos systems with a 
Wii Remote, and we think 
that’s pretty cool. 


Wiimote-loT 
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Controlled 

by a PlayStation 3 
gamepad, Revenge 
is a six-wheeled 
A3 class robot 

that can cope 

with a host of 
different surfaces 


When it comes to robots, 
Brian Corteil is a master maker 


f you’ve read The MagPi 
before, you’ll recognise 
Brian Corteil’s name. From 
tutorials and events, to online 
discussion and Pi parties, it’s likely 
youll bump into him with a robot 
in one hand and some other mad 
creation in the other. 
Trained as an electrician, Brian’s 
interest in electronics came 
into play with the release of the 
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Arduino and, later, the Raspberry 
Pi, after he was able to obtain one 
of the first 10000 Model Bs. By day, 
he’s an integrated security systems 
engineer, installing service access 
control, CCTV, and intruder 
alarms. And by night, Brian is a 
keen and successful robot builder. 

The annual Pi Wars challenge is 
where Brian’s robot-making skills 
truly shine. In fact, if you were to 
ever bump into Brian at his local 
Cambridge Makespace, he’d likely 
be tweaking his latest robot buggy 
or building new track for the main 
event. And the time and effort put 
in definitely has its rewards, with 
Brian taking first place in several 
of the pro courses of this year’s Pi 
Wars, missing out on overall first 
place by a mere one point. 


Robotics made easy 
Outside of Pi Wars, Brian is also 
the head of Coretec Robotics, 
responsible for the Tiny 4WD, a 
mini robot originally designed for 
The MagPi’s ‘Build your own Pi 
Wars robot’ feature in issues 51 and 
52. The success of the robot turned 
4WD into a consumer project kit 
that avid makers can buy and build 
themselves using laser-cut parts, 
a Raspberry Pi Zero W, a handful 
of electronics, and the Pimoroni 
Explorer pHAT. “I have to thank 
the salty sea dogs of Pimoroni 

for kicking me up the bum to get 
Tiny out in the wild,” he jokes 
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when talking to us about Coretec. 
“Over the next year or so, I will be 
releasing helpful breakout boards 
for making robotics and making a 
little easier.” 

Brian also tries to attend as many 
events as possible, from Maker 
Faires to Raspberry Jams, and can 


Micro Pi Noon pits balloon-clad 
robots against each other, with 
the last balloon holder standing 
hailed the winner 


When it comes to discussing his 
project builds and robots, Brian 
is first to list the people to whom 
he’s beholden. “I like to thank the 
people who have supported me in 
my adventures in making, first of 
all the members of Makespace for 
helping me turn my crazy ideas into 


Thousands of balloons have been 
sacrificed to the maker gods 


often be found demonstrating 
Micro Pi Noon, based on Michael 
Horne and Tim Richardson’s Pi 
Wars Pi Noon challenge. Two 
competitors battle to pop the 
balloons attached to each other’s 
robots; the last to retain an inflated 
balloon is the winner. “Thousands 
of balloons have been sacrificed to 
the maker gods,” he admits. 


working things,” he begins, before 
mentioning organisations such as 
Pimoroni, Tim and Mike (the minds 
behind Pi Wars), and makers Robert 
Karpinski and Mark Mellows “for 
checking my electronic designs and 
answering my silly questions and 
their help in being awarded a blue 
ribbon at this year’s Maker Faire UK 
in Newcastle.” 


JIM: 


Brian won a blue ribbon 
at this year’s Maker j 
Faire Newcastle for his 


robot builds, including 
the six-wheel Revenge 
and A6-sized Tiny 
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EVENT CALENDAR 


Find out what community-organised, Raspberry 
Pi-themed events are happening near you... 


FAISALABAD acne 
RASPBERRY JAM {eae A 
>, 


Want a Raspberry Jam in your 
area? Want to start one? Email 


Ben Nuttall to find out more: 


jam@raspberrypi.org 


GTA RASPBERRY PI JAM 
When: Thursday 5 July 
Where: Civic Centre Resource 
Library, Vaughan, 
ON, Canada 
magpi.cc/CMhJUg 
Makers, tinkerers, coders, and 
lovers of playing with technology 
unite for this free Jam! 


SAHIWAL RASPBERRY JAM 

When: Monday 9 July 

Where: E-Rozgaar Center, 
Sahiwal, Pakistan 

magpi.cc/yHzkXy 

A Maker.pk-organised 

Raspberry Jam in Pakistan, one 

of two this month, and free 

for all to attend! 
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OLIVE BRANCH 


6-6 REGULAR EVENTS 


FAISALABAD 

RASPBERRY JAM 

When: Thursday 19 July 

Where: University of Agriculture, 
Faisalabad, Pakistan 

magpi.cc/XcpdWu 

The second major Pakistani 

Raspberry Jam this month, 

which is also free for everyone. 


OLIVE BRANCH 

RASPBERRY JAM 

When: Saturday 28 July 

Where: B.J. Chain Public Library, 
Olive Branch, MS, USA 

magpi.cc/WxeYYR 

A free family event to learn 

about coding and play with 

the Raspberry Pi. 


RASPBERRY JAM 


SAHIWAL 
RASPBERRY JAM 


PRESTON 

RASPBERRY JAM 

When: Monday 2 July 

Where: Media Factory Building, 
Preston, UK 

magpi.cc/BvJeFL 

A community of people who meet 

to learn, create, and share the 

potential of the Raspberry Pi. 


OXFORD RASPBERRY JAM: 

EVENING FLAVOUR 

When: Tuesday 3 July 

Where: Oxford Centre For 
Innovation, Oxford, UK 

magpi.cc/XixtqF 

An evening meet-up for Raspberry 

Pi enthusiasts! Suitable for adults 

and accompanied young people. 
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LEEDS 
RASPBERRY JAM 

When: Wednesday 4 July 

Where: Swallow Hill Community, 


Leeds, UK 
magpi.cc/zNNDeX 
Get hands-on with digital making | use Twitter and Facebook. I've found ay 9 ~ £ MM 
activities through the workshop. Plus it useful to get the message directly to Pa “4 oo) 
a hackspace area to share projects. schools who use Twitter, so the IT specialist i. a N 
can pass the message on to parents and 
YORK children. | think old-fashioned posters put 
RASPBERRY JAM up around the area work well too. 
When: Monday 16 July Anne Carlill 
Where: Acomb Explore Library, York Raspberry Jam 
York, UK 


e JAM : 


magpi.cc/hbfvvK 

York Pi Jam is an event for 
people of all skill levels who 
want to learn more about the Pi. 


Every Raspberry Jam is entitled to apply for a 
Jam starter kit, which includes magazine issues, 
printed worksheets, stickers, flyers, and more. 
Get the guidebook here: magpi.cc/2q9DHfQ 
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LETTERS 


MUSICALLY MORE 
NORA THAN 


I’ve used a Raspberry Pi for a few years in I I N Í J X 
different electronics projects - some robots, the 


odd automatic light, that kind of thing — but I’ve 
become interested recently in having my music I like using Raspbian on the 
controlled and played from my Raspberry Pi. Raspberry Pi, but I’m not very 
I know there’s the headphone jack and you can used to Linux and those types 
do digital audio via the HDMI port, but is there a of operating systems. I’ve also 
way to get better audio out of the Raspberry Pi? seen that a lot of other operating 
With that in mind, would you say the Raspberry systems for the Pi are based on 
Pi is generally good for a jukebox or party music Linux. Is there any way I can use 
application? Whether you’re DJing or just letting Windows on my Raspberry Pi? 
it play from a playlist? Emilio 
Martin 
As the Raspberry Pi is mainly 
Among the most common add-ons we see for designed for education, using 
the Raspberry Pi are DACs that offer high-quality something like Raspbian is a 
audio output designed for sound systems. A lot great way for people to learn 
of them come as HATs which slot on top of the about computing and coding. 
Raspberry Pi, making it all very compact, and It’s also slightly easier to get a 
several include RCA jacks or optical out. Linux distribution to work on the 
There are plenty to choose from, but we quite 
like the Nanomesher series of DACs as they include 
a screen and you can get an optional 3D-printed 
case to fit them. 
As for DJing with one - the Raspberry Pi is just a 
computer, so as long as you can find software you 
like to use for it, you can play music as you wish. 
We’ve also seen Sam Aaron, creator of Sonic Pi, 
do live DJing with the music creation software. 
There’s plenty you can do with it! 


The NanoSound DAC Pro is 
one of our favourite recent 
DACs for better audio 


While full Windows is not readily available 
for the Raspberry Pi, the loT Core version is 


Raspberry Pi due to its relatively 
low power and use of an ARM 
processor — Windows runs on 

x86 computers with much more 
powerful processors and such. 
However, while you won’t be 
getting a Windows 10 SD card 

like you would an installation CD 
for your computer, people have 
been figuring out how to hack 
Windows 10 to run on Raspberry Pi. 
It doesn’t run particularly well but 
if it’s good enough for you to use, 
we suggest taking a look into it. 
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ere in Africa, PDFs are a lot more 
practical than printed magazines. 
I have PDEs of The Official Raspberry 
Pi Projects Book - Volume 1 and 2, but can’t 
find Volume 3. Is this available to download? 
Where can I find it? 
DaveSemm 


Anyone having trouble finding the PDF for The 
Official Raspberry Pi Projects Book Volume 3 should 
head here: magpi.cc/projects3 — you’ll see a 
button that says ‘Download Free’ which lets you 
get the PDF for the book. 

This button can be found on every issue and 
book’s page on our website to get the PDF for 
free, to make it 
easier for people 
like you who 
cannot get the 
printed editions. 

You can even 
read them on 
the Raspberry Pi 
as well! 


As well as every 

issue of the 

magazine, the 

Projects Books 

are available as of Racing 
a free PDF! 
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The Raspberry Pi Forum is a hotbed of conversations 
and problem-solving for the community - join in via 
raspberrypi.orgjforums 


Sandbender 
Technology 


CAN Interface pHAT 


Easily turns a Raspberry Pi into a low 
cost CAN bus equipped controller. 


SPI MCP2515 CAN Controller 
e Isolated CAN Transceiver 
e Real Time Clock 


e Logging Memory 


www.sandbendertechnology.com 
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CAN YOU HELP INSPIRE 
THE NEXT GENERATION Ç 


OF CODERS? 


Code Club is a network of volunteers and 
educators who run free coding clubs for 
young people aged 9-13. 


la! To find out more, join us at 


In association with 


sf Astroprint 


ASTROBOX 
TOUCH & 
GATEWAY 


AstroPrint makes 3D printing easy with 
its AstroBox Touch and Gateway kits. 
These devices enable you to monitor 
and control a 3D printer from anywhere 
in the world. 


Most 3D printers come with very basic 
controls, and AstroBox uses a Raspberry 
Pi to add a professional software layer 
on top of a basic 3D printer. 


= AstroBox 


20g 


File Upload File Manager control 


EM a 


Thingiverse MyMiniFactory  3DPrintCloud 


Supplies 


With AstroBox you can download 3D 
printer files from a range of websites 
and print the models directly from 
your printer. 


Enter now at magpi.cc/win 


Terms & Conditions 

Competition opens on 27 June 2018 and closes on 27 July 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry 
Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the 
competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from 
The MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable 
and no cash alternative will be offered. Winners will be contacted by email to arrange delivery. Any winners who have not responded 60 days after the initial 
email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Column THE FINAL WORD 


any years ago at a Maker Faire, I received a 
bracelet with the words ‘Show what you make, 
share what you learn’ inscribed on it. Ever 
since then, those words have stuck with me because 
they encapsulate such an important aspect of the 
Raspberry Pi community and the maker movement at 
large. We’re not a community only because we have a 
common interest in making things with technology. 
We’re a community because we generously share our 
projects and our knowledge. It’s an important part of 
the maker ethos and it’s why events like Maker Faire 
are such a key aspect of the movement. 


Meet and share 

As I’ve discussed here before, there’s a fantastic 
community of Raspberry Pi enthusiasts sharing 
projects and knowledge online on sites such as 

Reddit, Twitter, Hackaday, Make, and Instructables. 
But nothing quite beats face-to-face interaction for 
sharing and community-building. We at the Raspberry 
Pi Foundation want to provide opportunities for 
members of our community to see and meet each other 
and have the opportunity to share. 

For example, Coolest Projects is a showcase event 
for young people to share what they’ve created with 
technology. This event sprang from the CoderDojo 
movement and has become huge in Dublin over the 
past few years. We launched this event in the United 
Kingdom a few months ago and we’re excited to bring 
it to California in September for young digital makers 
in North America. More details about it can be found 
at coolestprojects.org/northamerica. 

For youth and adults in the Raspberry Pi 
community, Raspberry Fields is an opportunity to 
share their projects, products, and anything related 
to Raspberry Pi. The event is new this year and takes 
place in Cambridge during the summer. Read more 
about it in this issue of The MagPi. And if you aren’t 
able to make it to Raspberry Fields this time around, 
check out the Raspberry Jam map (rpf.io/jam) for a 
Jam happening near you. 
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MATT RICHARDSON 


Matt Richardson is the Executive Director of the Raspberry 
Pi Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


Matt Richardson 
on how sharing isa 
critical part of creating 


The purpose of events such as Coolest Projects, 
Raspberry Fields, Maker Faires, and Raspberry Jams 
is to give makers a platform to show their projects 
and share the knowledge they’ve gained through the 
process of making. When a person creates something 
or figures something out, it’s natural for them to 
want to share that object and the experience of 
creating it with others. Have you ever solved a tough 
real-world problem and just couldn’t wait to tella 
friend about how you did it? Sharing that experience 
greatly enhances the feeling of accomplishment. 


When makers share, 
it Inspires, encourages, 
and educates others 


That feeling of accomplishment will give you 
motivation to continue creating and solving. 


Inspire others 

When makers share, it inspires, encourages, 

and educates others. I joined the maker movement 
after I saw the projects that others were making and I 
said to myself, “I wish I could do that too.” Because I 
was able to talk to those makers and hear the details 
about how they created their projects, I felt supported 
and encouraged to try it on my own. I went from 
wishing I could do it to actually doing it because of 
how much inspiration and knowledge those makers 
had shared. And now I don’t consider my own projects 
complete until I’ve shared them with the world. 

Could you even imagine what it would be like if 
members of our community didn’t share their projects 
and knowledge so freely? If that were the case, I don’t 
even think we could consider ourselves a community. 
Sharing is what makes us more than just a group of 
people with a common interest; it is what makes 

us acommunity. 
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THE Official 
RASPBERRY PI 
EGINNERS BOOK 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adapters 

8GB microSD card 

116-page beginner’s book 
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The pocket-sized desktop computer! .——— g 
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magpi.cc/store 
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A Viley Brai 


Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry Pj board and case 
Power supply and HDMI cable 


Available for worldwide shipping at: 
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Available in Europe 
through RS Components 


$89” £097” 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. Canakit is a registered 
trademark of Cana Kit Corporation. 
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